Ang kasagaran nga kompanya sa IT adunay mga kinahanglanon, usa ka kasaysayan sa mga tracker sa buluhaton, mga gigikanan (tingali bisan sa mga komento sa code), mga panudlo alang sa kasagaran, hinungdanon ug komplikado nga mga kaso sa produksiyon, usa ka paghulagway sa mga proseso sa negosyo (gikan sa onboarding hangtod sa "kung unsaon pagbakasyon. ”), mga kontak, mga yawe sa pag-access, mga lista sa mga tawo ug mga proyekto, mga paghubit sa mga bahin sa responsibilidad - ug usa ka hugpong sa uban pang mga kahibalo nga tingali nakalimtan namon ug mahimo’g tipigan sa labing katingad-an nga mga lugar.
Kahibalo =/= dokumentasyon. Dili kini mapasabot, kinahanglang hinumdoman
Giunsa pagsiguro nga kadtong kinahanglan nga mahibal-an ang usa ka butang gikan niini nakasabut kung diin ug kung giunsa kini makit-an, ug ang tanan nga kinahanglan nga mahibal-an ang mga indibidwal nga mga butang ug mga kasabutan mahimo dayon ug tukma nga mahibal-an ang bahin sa mga pagbag-o niini.
Sa katapusan nga yugto sa podcast nga "Team Lead Will Call", ang mga lalaki gikan sa Skyeng naghisgot bahin sa pagdumala sa kahibalo kauban si Igor Si Tsupko usa ka tawo sa komite sa programa sa KnowledgeConf ug ang "direktor sa wala mailhi" sa Flant.
Ang bug-os nga recording anaa ingon , ug sa ubos nakolekta namo ang pipila ka makapaikag nga mga tip ug mga link sa mapuslanon nga mga materyales nga gihisgutan sa audio o gipalapdan ang impormasyon gikan niini. Nindot kaayo kung ipaambit usab nimo ang mga hack ug trick sa imong team sa mga komento.
Una nga hack: dili na nimo kinahanglan mahibal-an kung unsang sistema ang tan-awon
"Gikuha nako ang among mga gigikanan sa kahibalo ug gihimo ang usa ka kinatibuk-ang pagpangita alang kanila: usa ka bintana nga adunay sistema sa pagsala aron makunhuran ang lugar sa pagpangita. Oo, sa parehas nga oras, kinahanglan nimo nga bantayan ang kalidad niini, pun-on ang base sa kahibalo, ug pakigbugno ang pagdoble ug sayup nga kasayuran.
Usa ka piraso sa papel aron makit-an kana ra
Apan na, mga 60% sa mga inhenyero sa Flant naggamit niini nga pagpangita labing menos 1-2 ka beses sa usa ka adlaw - ug kasagaran makakita og mga tubag sa una o ikaduha nga mga posisyon. Ug sa porma sa pruweba sa konsepto mao ang pag-indeks sa mga dokumento sa Google: ang tanan nga mga dox, folder, van drive, ug uban pa - kining tanan dali usab nga madala sa internal nga pagpangita.
Ikaduha nga hack: kung giunsa dili makalimtan ang hinungdanon nga hinungdanon nga mga butang sa usa ka hugpong sa mga chat
"Kung nagtrabaho ka sa usa ka gipang-apod-apod nga team, nan tingali usa ka hinungdanon nga bahin sa imong adlaw ang gigugol sa Slack - ug kung diin naanad ka sa pagbuhat sa usa ka butang nga sama niini: "@myteam, tabang / tan-awa / pagsulod sa husto ... ”.” Apan adunay problema sa kadaghan sa kasayuran - ug ang usa ka bulag nga paghisgot mahimong makalimtan taliwala sa ubang mga mensahe.
Sa Skyeng gitabangan kami sa usa ka bot diin mahimo nimong isulat ang usa ka mensahe ug tag bisan unsang gidaghanon sa mga tawo o grupo. Gigamit namo kini sa mga kaso diin importante kaayo nga ang mga tawo mobasa o mo-reaksyon: kini modukdok nga walay katapusan hangtud nga imong i-press ang "Gibasa ko" nga buton - dili nimo kini malaktawan o ibaliwala."
Pangutana nga tubagon: unsay buhaton sa dokumentasyon?
"Daghang kahibalo gikan sa mga tech, apan dili tanan nahibal-an kung giunsa kini paghulagway nga maayo.
Human sa tanan, wala ka'y bisan unsang compiler o linter nga magsulti kanimo kung imong gibuhat kini sa husto o dili - ug kasagaran ang output nga anaa kanamo dili masabtan, dili maayo nga pagkaporma ug dili kompleto nga teksto. Siyempre, kinahanglan nimo nga buhaton kini nga normal, dili tungod kay adunay usa nga miabut ug miingon nga "kinahanglan kini" - buhaton nimo kini nga maayo alang sa imong kaugalingon: sa usa o duha ka bulan imong basahon kini ug masabtan. Ug ang laing tawo, nga nagbukas sa usa ka dokumento, dili dayon magsira niini hangtod sa hangtod, nga nahibal-an nga kini wala’y kapuslanan.
Kabahin sa podcast nga gipahinungod sa pangutana nga "Pila ka mga tawo ang gikinahanglan aron magsulat ug maayong dokumentasyon o maghimo usa ka normal nga demo"
Apan ang pangutana nagpabilin: pila ka oras ang igahin alang niini ug kung giunsa kini mahimo nga epektibo?
Ug kung adunay usa ka matinud-anon nga tubag dinhi: gawas kung ang mga negosyante nga nalambigit, ug gawas kung sila empirically makasinati sa epekto sa maayo nga dokumentasyon, adunay usa ka risgo nga ang paningkamot mohatag og gamay nga pagbalik. Kini usa ka istorya bahin sa pagbag-o sa kultura.
Alang sa uban, ang kasinatian ug pagtudlo makaluwas kanimo. Ang mga analogue sa pares nga programming, pagsubay sa pag-uswag ug mga pagrepaso sa code mahimong angay dinhi - nagpakita sa labing kaayo nga mga gawi, nagpunting sa mga sayup ug makalaay sa katapusan.
Bonus: "Sige, sultihan ko sila niining paagiha, masabtan nila"
Ang pangutana nga "unsa ka oras nga igugol niini ug sa unsang lebel nga buhaton kini" hinungdanon dili lamang sa sulod sa gambalay sa dokumentasyon, apan sa kinatibuk-an alang sa pagbalhin sa bisan unsang kahibalo. Ang demo usa usab ka maayong panig-ingnan sa pagpaambit sa impormasyon. Apan adunay mga nuances: pananglitan, kung unsaon pagsiguro nga gamay ra ang oras.
Ang channel sa pagpaambit sa kahibalo taliwala sa kalamboan: internal nga mga taho, mapuslanong libro, artikulo, ug uban pa. Ang structured extract gitipigan usab sa Notion.
Sa bahin, kini nga mga problema masulbad pinaagi sa praktis sa internal nga mga taho. Kas-a sa usa ka semana, 40-60 ka minuto ang gikuha sa usa ka dili kaayo busy nga oras - ug ang mga lalaki naghimo usa ka taho sa video alang sa mga kauban gikan sa lainlaing mga proyekto. Frontend team sa yawe nga produkto - Vimbox - bahin sa imong UI kit, nga mahimong tema alang sa bisan unsang ubang proyekto. Ang grupo sa pagpalambo sa marketing naghisgot bahin sa usa ka librarya alang sa pagsubay ug pag-log sa mga hangyo, nga nakadani dayon sa interes sa daghang ubang mga proyekto. Gipaambit sa team sa proyekto sa Matematika ang ilang kasinatian sa pagbalhin gikan sa REST API ngadto sa GraphQL. Ang grupo sa mga leksyon sa grupo naghunahuna sa pagpaambit kung giunsa nila ang una nga pagbalhin sa PHP 7.4. Ug uban pa.
Ang listahan gipadayon sukad Mayo 2018 ug adunay kapin sa 120 ka mga entries
Ang tanan nga mga miting gisugdan pinaagi sa corporate Google Meet, girekord ug sa sulod sa 1.5 ka oras makita sa usa ka folder sa usa ka gipaambit nga Google drive, ug ang mga link sa mga pagrekord gidoble sa parehas nga Slack. Kana mao, dili ka kinahanglan nga moadto kung adunay usa ka emerhensya, apan tan-awa kini sa ulahi sa 20 nga tulin - kasagaran ang taho mismo molungtad hangtod sa XNUMX minuto, ug ang panaghisgot - kung giunsa kini. Apan dili kami molapas sa oras)
PS Unsa ang nagtrabaho ug wala nagtrabaho alang kanimo?
Mapuslanon nga sumpay:
- Rodion Nagornov gikan sa Kaspersky Lab mahitungod sa ug nganong dili kini dokumentasyon (salamat sa channel ni Igor alang sa link , adunay daghan pa nga ingon niana).
- Igor Tsupko gikan sa Flant bahin niana sa akong kompanya
- Alexey Kataev gikan sa Skyeng (mga kal-ang sa kahibalo sa mga teknolohiya ug piho nga mga lugar) sa usa ka gipang-apod-apod nga grupo.
- Sergey Goncharuk gikan sa Flant bahin sa paghatud sa kasayuran - , kung makasugat ka og problema sa usa ka gipang-apod-apod nga team.
Source: www.habr.com