Hello sa tanan!
Ang akong ngalan kay Masha, nagtrabaho ko isip usa ka inhenyero sa kalidad nga kasiguruhan sa grupo sa mga kompanya sa Tinkoff. Ang trabaho sa QA naglakip sa daghang komunikasyon sa lainlaing mga tawo gikan sa lainlaing mga grupo, ug usa usab ako ka manedyer ug magtutudlo sa mga programa sa edukasyon, mao nga ang akong mapa sa komunikasyon labi ka lapad kutob sa mahimo. Ug sa usa ka punto mibuto ako: Nakaamgo ko nga dili nako mahimo, dili nako mahimo, dili nako mapuno ang impyerno nga tonelada nga dili mabasa nga mga lamesa ug mga dokumento.
Sigurado nga ang matag usa kaninyo karon naghanduraw sa akong gihisgutan ug mibuto sa bugnaw nga singot: mga lista sa mga apelyido nga walay alpabetikong han-ay, mga lamesa nga adunay gatusan ka mga kolum nga adunay hiwi nga layout, mga lamesa nga adunay liboan ka mga linya diin kinahanglan nimo nga pahiran ang imong tudlo. sa mouse ligid sa pagtan-aw header, tonelada sa mga panid sa dili maihap nga mga instruksyon, gatusan ka mga sulat nga gipadala ngadto sa usag usa uban sa data nga kinahanglan nga analisahon ug systematize ug stuffed ngadto sa parehas dili mabasa nga mga lamesa.
Ug busa, sa dihang nabugnawan kog gamay, nakahukom ko nga isulat kini nga artikulo. Maghisgot ako kung giunsa nimo mahimo nga normal (bisan usahay komportable) nga mapadayon ang lainlaing mga dokumentasyon nga dili produkto. Nanghinaut ko nga ang artikulo mokaylap sa Internet ug ang lebel sa impyerno sa mga departamento nga kasikbit sa kalamboan mokunhod bisan gamay, ug ang mga tawo (lakip ang akong kaugalingon) mahimong mas malipayon.
Mga himan
Ang dokumentasyon sa produkto kanunay nga gitago sunod sa code, nga usa ka maayong butang. Ug ang dili produkto nga dokumentasyon kasagarang gitipigan bisan asa. Kanunay nga gisulayan sa mga tawo nga ibalhin ang kasayuran gikan sa lainlaing mga lugar ngadto sa Confluence, ug dili kami eksepsiyon. Mao nga ang nahabilin nga istorya bahin kaniya.
Sa kinatibuk-an, ang Confluence usa ka advanced wiki engine. Gitugotan ka nga magtrabaho uban ang datos sa lainlaing mga lahi sa pagpakita: teksto nga adunay pag-format, mga lamesa, lainlaing mga tsart. Kini mao ang usa ka kaayo nga makapaikag ug gamhanan nga himan, apan kon kamo wala mahibalo kon sa unsang paagi sa pag-andam niini, unya ikaw matapos uban sa laing dump sa dili mabasa nga mga dokumento. Tudluan ko ikaw unsaon pagluto!
Mga macro
Hapit tanan nga salamangka sa Confluence naggikan sa mga macro. Adunay daghang mga macros, ug sila mahimong ikombinar sa usag usa. Mahimo silang bayran o libre; sa ubos adunay lainlaing mga pananglitan sa mga macro nga adunay mga link sa dokumentasyon alang kanila.
Ang interface alang sa pagtrabaho sa mga macros kay yano kutob sa mahimo. Aron makadugang usa ka macro, kinahanglan nimo nga i-klik ang plus ug pilia ang gusto nga elemento gikan sa lista.
Kung ang usa ka macro adunay kaugalingon nga sulud, sa ato pa, wala na kinahanglana ang pagsal-ot sa bisan unsang butang sa sulod mismo, kini sama sa usa ka bloke.
Kung ang usa ka macro nanginahanglan usa ka butang nga ibutang sa sulod niini aron kini molihok, kini sama sa usa ka frame.
Sa parehas nga oras, mahimo nimong ibutang ang daghang uban nga gusto nimo sa sulod sa usa ka frame, basta adunay lohika sa imong piramide.
Ang matag macro adunay usa ka preview: kini diha-diha dayon nagpakita kung imong gipuno ug gi-configure ang macro sa husto.
Mga pattern
Gawas pa sa mga macro, adunay usa ka kombenyente nga himan alang sa pre-filling content - usa ka template.
Mahimong gamiton ang mga templates sa paghimo og bisan unsang panid: pag-klik lang sa tulo ka tuldok sunod sa buton nga "Paghimo" ug pilia ang gusto nga template.
Unya ang tanan nga sulud nga naa sa template idugang sa gibuhat nga panid.
Bisan kinsa makahimo og mga panid gikan sa mga templates, apan kadto lang adunay katungod sa paghimo o pag-edit sa mga templates mismo ang makahimo niini. Mahimo nimong idugang ang dugang nga mga panudlo sa template kung giunsa ang pagmentinar sa panid.
Ang salamangka sa mga lamesa
Sa tinuud, isip usa ka techie, ganahan kaayo ko sa mga lamesa ug makaputos sa halos bisan unsang impormasyon niini (bisan dili kini kanunay nga epektibo). Ang mga lamesa mismo tin-aw, istruktura, scalable, mahika!
Apan bisan ang usa ka talagsaon nga entidad sama sa usa ka lamesa mahimong maguba. Ug mahimo nimo kini nga malampuson nga magamit ug mapauswag pa kini. Dugang niini sa ubos.
Pagsala (bayad nga plugin)
Ang bisan unsang dako, dili mabasa nga lamesa mahimo nga gamay nga dili kaayo dako ug gamay nga mabasa gamit ang pagsala. Mahimo nimong gamiton ang usa ka bayad nga macro alang niini .
Kinahanglan nimo nga ibutang ang usa ka lamesa sa sulod niini nga macro (bisan ang labing ngil-ad nga mahimo, ang panguna nga butang mao ang pagduso niini sa kinatibuk-an). Sa macro, makapili ka ug mga column para sa drop-down filter, text filter, numeric filter, ug date filter.
Hunahunaa lang nga ang tanang impormasyon sa mga kandidato alang sa tanang bakante natala sa usa ka tabular list. Natural lang, wala mapili - ang mga tawo moadto sa mga interbyu dili sa alpabetikong pagkahan-ay. Ug kinahanglan nimong masabtan kung nakainterbyu ka ba sa usa ka piho nga aplikante kaniadto. Kinahanglan nimo nga ibutang kini nga impyerno sa usa ka filter nga macro, pagdugang usa ka filter sa teksto pinaagi sa apelyido - ug voila, ang kasayuran naa sa imong screen.
Angay nga hinumdoman nga ang pagsala sa dagkong mga lamesa mahimong makaapekto sa pasundayag sa sistema ug mga oras sa pagkarga sa panid, mao nga ang pagbutang sa usa ka dako nga lamesa sa usa ka salaan usa ka temporaryo nga saklay; mas maayo nga maghimo usa ka proseso diin ang mga tawo dili kinahanglan nga maghimo mga dagko, dili mabasa nga mga lamesa (usa ka pananglitan sa proseso anaa sa katapusan sa artikulo).
Pagsunud-sunod (bayad nga plugin)
Paggamit sa usa ka magic macro Mahimo usab nimo nga itakda ang default nga pagsunud sa bisan unsang kolum ug numero ang mga linya. O i-klik ang bisan unsang kolum sa lamesa nga gisal-ut sa filter nga macro, ug ang paghan-ay mahitabo sa kana nga kolum.
Pananglitan, ikaw adunay parehas nga lamesa sa mga aplikante ug kinahanglan nimo nga banabanaon kung pila ang mga interbyu nga gihimo sa usa ka bulan - pagsunud sa petsa ug paglipay.
Pivot tables (bayad nga plugin)
Karon magpadayon kita sa usa ka mas makapaikag nga kaso. Hunahunaa nga ang imong lamesa dako ug kinahanglan nimo nga kuwentahon ang usa ka butang gikan niini. Siyempre, mahimo nimong kopyahon kini sa Excel, kuwentahon kung unsa ang imong kinahanglan ug i-upload ang datos balik sa Confluence. Mahimo ba nimo gamiton ang macro kausa? ug makuha ang parehas nga resulta, gi-update ra.
Pananglitan: ikaw adunay usa ka lamesa nga nagkolekta sa datos gikan sa tanan nga mga empleyado - diin sila nahimutang sa heyograpiya ug kung unsang mga posisyon ang ilang giokupar. Aron makalkulo kung pila ka tawo ang naa sa matag lungsod, kinahanglan nimo nga pilion ang linya sa PivotTable macro nga nagtipon sa datos (lokasyon) ug tipo sa operasyon (dugang).
Natural, mahimo ka nga mag-grupo sa daghang mga pamatasan sa usa ka higayon, ang tanan nga mga posibilidad mahimong matan-aw .
Mga tsart (bayad nga plugin)
Sama sa akong giingon, dili tanan nahigugma sa mga lamesa sama kanako. Ikasubo, kadaghanan sa mga manedyer dili ganahan kanila. Apan ang tanan nahigugma gayud sa mahayag nga kolor nga mga diagram.
Ang mga tiglalang sa Confluence siguradong nahibal-an bahin niini (tingali sila adunay mga boss nga nahigugma sa mga taho ug mga diagram, asa sila kung wala kini). Busa, mahimo nimong gamiton ang magic macro . Sa kini nga macro kinahanglan nimo nga ibutang ang pivot table gikan sa miaging parapo, ug voila - ang imong abuhon nga boring data nindot tan-awon.
Siyempre, kini nga macro adunay mga setting usab. Ang usa ka link sa dokumentasyon alang sa bisan unsang macro makit-an sa mode sa pag-edit sa kana nga macro.
Sayon nga panagsama
Ang impormasyon gikan sa miaging mga paragraph tingali dili usa ka pagpadayag alang kanimo. Apan karon nahibal-an na nimo kung giunsa ang paggamit sa mga macro, ug makapadayon ako sa labi ka makapaikag nga bahin sa artikulo.
Mga label
Dili maayo kung ang mga tawo magtipig og impormasyon sa usa ka wala matukod nga artikulo o usa ka dako nga lamesa. Mas grabe pa kung ang mga bahin sa kini nga kasayuran dili lamang dili mabasa nga pormat, apan nagkatag usab sa tibuuk nga Confluence. Maayo na lang, posible nga makolekta ang nagkatag nga kasayuran sa usa ka lugar. Aron mahimo kini kinahanglan nimo nga gamiton (mga tag nga pamilyar sa tanan gikan sa mga social network).
Mahimo nimong idugang ang bisan unsang gidaghanon sa mga tag sa bisan unsang panid. Ang pag-klik sa usa ka tag magdala kanimo sa usa ka panid sa panagsama nga adunay mga link sa tanan nga sulud sa kana nga tag, ingon man usa ka hugpong sa mga may kalabutan nga tag. Ang mga may kalabotan nga tag mao kadtong kanunay nga makita sa parehas nga panid.
Mga kabtangan sa panid
Mahimo nimong idugang ang lain nga makapaikag nga macro sa panid aron matukod ang kasayuran - . Sa sulod niini kinahanglan nimo nga isumite ang usa ka lamesa nga adunay duha ka kolum, ang una mao ang yawe, ug ang ikaduha mao ang kantidad sa kabtangan. Dugang pa, ang macro mahimong matago gikan sa panid aron dili kini makabalda sa pagbasa sa sulud, apan ang panid markahan gihapon sa kinahanglan nga mga yawe.
Hatagi'g pagtagad ang ID - kini sayon ββββnga ibutang kini aron mag-assign sa lain-laing mga grupo sa mga kabtangan ngadto sa lain-laing mga panid (o bisan lain-laing mga grupo sa mga kabtangan ngadto sa usa ka panid).
Mga taho
Mahimo nimong kolektahon ang mga taho gamit ang mga tag. Pananglitan, macro nagkolekta sa tanan nga mga panid nga adunay usa ka piho nga hugpong sa mga tag.
Apan ang usa ka mas makapaikag nga taho mao ang macro . Gikolekta usab niini ang tanan nga mga panid nga adunay usa ka piho nga hugpong sa mga tag, apan dili lamang kini magpakita sa usa ka lista niini, apan nagmugna usa ka lamesa (nakuha ba nimo ang koneksyon sa sinugdanan sa artikulo?), diin ang mga kolum mao ang panid mga yawe sa kabtangan.
Ang resulta mao ang usa ka summary table sa impormasyon gikan sa lain-laing mga tinubdan. Nindot nga kini adunay kombenyente nga mga gimbuhaton: adaptive layout, pagsunud sa bisan unsang kolum. Usab, ang ingon nga lamesa sa pagreport mahimong ma-configure sa sulod sa usa ka macro.
Kung nag-configure, mahimo nimong tangtangon ang pipila ka mga kolum gikan sa taho, magbutang usa ka default nga estado o ang gidaghanon sa mga rekord nga gipakita. Mahimo usab nimong itakda ang ID sa propyedad sa panid aron makita ra ang kasayuran nga imong gikinahanglan.
Pananglitan, ikaw adunay daghang mga pahina sa empleyado, kini nga mga panid adunay usa ka hugpong sa mga kabtangan mahitungod sa tawo: unsa nga lebel siya, asa siya, sa dihang siya miapil sa team, ug uban pa. Kini nga mga kabtangan gimarkahan ID = empleyado_inf. Ug adunay ikaduha nga hugpong sa mga kabtangan sa parehas nga panid, nga adunay sulud nga kasayuran bahin sa tawo ingon bahin sa team: unsa nga papel ang gidula sa tawo, unsa nga team siya, ug uban pa. Kini nga mga kabtangan gimarkahan ID = team_inf. Unya, sa pag-compile sa usa ka report, mahimo nimong ipakita ang impormasyon lamang alang sa usa o duha ka ID sa usa ka higayon - bisan asa ang mas sayon.
Ang katahum niini nga pamaagi mao nga ang tanan makahimo sa pag-assemble sa lamesa sa impormasyon nga ilang gikinahanglan, nga dili magdoble sa bisan unsa ug ma-update kung ang main page ma-update. Pananglitan: dili igsapayan sa usa ka team lead kung ang iyang mga developers nakakuha og trabaho, apan kini importante kung unsa ang papel sa matag usa kanila sa team. Ang lider sa team mokolekta og report sa team. Ug ang accountant sa kasagaran dili magtagad kung kinsa ang naghimo sa unsa nga papel, apan ang mga posisyon hinungdanon - siya mag-compile sa usa ka taho sa mga posisyon. Sa kini nga kaso, ang gigikanan sa kasayuran dili madoble o ibalhin.
Katapusan nga proseso
Panudlo
Mao nga, mahimo naton nga matahum nga istruktura ug epektibo nga magtipon sa kasayuran sa Confluence gamit ang mga macros ingon usa ka pananglitan. Apan labing maayo, kinahanglan nimo nga sigurohon nga ang bag-ong kasayuran na-istruktura dayon ug nahulog sa tanan nga mga mekanismo sa panagsama nga gigamit na.
Dinhi diin ang usa ka hugpong sa mga macros ug templates moabut aron sa pagluwas. Aron mapugos ang mga tawo sa paghimo og bag-ong mga panid sa gusto nga pormat, mahimo nimong gamiton ang Paghimo gikan sa Template macro. Nagdugang kini usa ka buton sa panid, kung gi-klik, usa ka bag-ong panid ang gihimo gikan sa template nga imong kinahanglan. Niining paagiha mapugos nimo ang mga tawo sa pagtrabaho dayon sa format nga imong gikinahanglan.
Sa template nga gikan diin ka maghimo usa ka panid, kinahanglan nimo nga idugang ang mga label, usa ka macro nga "Mga Properties sa Panid" ug usa ka lamesa sa mga kabtangan nga kinahanglan nimo daan. Girekomenda usab nako ang pagdugang mga panudlo kung unsang mga kantidad ang kinahanglan pun-on sa panid, ug mga kantidad sa kabtangan.
Unya ang katapusan nga proseso ingon niini:
- Naghimo ka usa ka template alang sa usa ka piho nga tipo sa kasayuran.
- Niini nga template imong idugang ang mga label ug mga kabtangan sa panid sa usa ka macro.
- Sa bisan unsang kombenyente nga lugar, paghimo usa ka panid sa ugat nga adunay usa ka buton, pag-klik kung diin nagmugna usa ka panid sa bata gikan sa template.
- Gitugotan nimo ang mga tiggamit nga moadto sa panid sa ugat, nga mahimoβg makamugna sa kinahanglan nga kasayuran (sumala sa gikinahanglan nga template, pinaagi sa pag-klik sa usa ka buton).
- Gikolekta nimo ang usa ka taho sa mga kabtangan sa panid gamit ang mga tag nga imong gipiho sa template.
- Pagmaya: naa nimo ang tanan nga kinahanglan nga kasayuran sa usa ka kombenyente nga pormat.
Lit-ag
Isip usa ka dekalidad nga inhenyero, makaingon ko nga walay perpekto sa kalibotan. Bisan ang mga lamesa sa Diyos dili hingpit. Ug adunay mga lit-ag sa proseso sa ibabaw.
- Kung magdesisyon ka nga usbon ang mga ngalan o komposisyon sa mga kabtangan sa panid, kinahanglan nimo nga i-update ang tanan nga nahimo na nga mga butang aron ang ilang datos maapil sa husto sa summary report. Kini makapasubo, apan, sa laing bahin, kini nagpugos kanimo sa paghunahuna sa detalye mahitungod sa "arkitektura" sa imong set sa impormasyon, nga usa ka makapaikag kaayo nga buluhaton.
- Kinahanglan ka nga magsulat sa usa ka patas nga kantidad sa mga panudlo kung giunsa pun-on ang mga lamesa sa impormasyon ug paggamit sa mga tag. Apan sa laing bahin, mahimo nimong maigo ang tanan nga tama nga mga tawo sa kini nga artikulo.
Pananglitan sa pagtipig sa dili produkto nga dokumentasyon
Pinaagi sa proseso nga gihulagway sa ibabaw, mahimo nimong maorganisar ang pagtipig sa hapit bisan unsang kasayuran. Ang katahum sa pamaagi mao nga kini mao ang unibersal: sa higayon nga ang mga tiggamit maanad niini, sila mohunong sa paghimo sa usa ka gubot. Ang laing dako (apan dili libre) dugang mao ang abilidad sa pagkolekta sa nagkalain-laing mga estadistika sa langaw ug pagdrowing og nindot nga mga diagram base niini.
Hatagan ko ikaw usa ka pananglitan sa among proseso alang sa pagpadayon sa kasayuran bahin sa usa ka team.
Nakahukom kami nga maghimo usa ka kard sa empleyado alang sa matag tawo sa team. Tungod niini, kami adunay usa ka template sumala sa diin ang matag bag-ong tawo nagmugna niini nga kard alang sa iyang kaugalingon ug nagmintinar sa tanang personal nga impormasyon niini.
Sama sa imong makita, kami adunay usa ka detalyado nga talaan sa mga kabtangan ug diha-diha dayon adunay mga panudlo kung giunsa ang pagmentinar sa kini nga panid. Ang pipila sa mga tag gidugang sa mga empleyado mismo sumala sa mga panudlo; ang template naglangkob lamang sa mga nag-una: card tag empleyado-kard, tag sa direksyon direksyon-apil ug team tag team-qa.
Ingon usa ka sangputanan, pagkahuman ang tanan nakamugna usa ka kard alang sa ilang kaugalingon, nakuha ang usa ka kompleto nga lamesa nga adunay kasayuran sa mga empleyado. Kini nga impormasyon mahimong gamiton sa lain-laing mga punto. Ang mga tagdumala sa kahinguhaan mahimong mangolekta og mga kinatibuk-ang lamesa alang sa ilang kaugalingon, ug ang mga nanguna sa team makahimo og mga lamesa sa team pinaagi sa pagdugang og tag sa team sa pagpili.
Makita nimo ang lainlaing mga summary pinaagi sa mga tag, pananglitan qa-upgrade-plano Ang tanan nga mga buluhaton sa pagpalambo sa QA ipakita. Sa parehas nga oras, ang matag tawo nagtipig usa ka hinungdanon nga kasaysayan ug iyang kaugalingon nga plano sa pag-uswag sa iyang kard sa empleyado - nagmugna usa ka nested nga panid gikan sa template sa mga plano sa pag-uswag.
konklusyon
Hupti ang bisan unsang dokumentasyon sa paagi nga walaβy kaulaw niini, ug dili kini hinungdan sa grabe nga kasakit sa mga tiggamit!
Naglaum gyud ko nga ang artikulo mahimong mapuslanon ug ang order moabut sa tanan nga dokumentasyon sa kalibutan.
Source: www.habr.com