Kompania mesatare e IT-së ka kërkesa, një histori të gjurmuesve të detyrave, burime (ndoshta edhe me komente në kod), udhëzime për raste tipike, të rëndësishme dhe komplekse në prodhim, një përshkrim të proceseve të biznesit (nga futja në bord te "si të shkosh me pushime ”), kontaktet, çelësat e aksesit, listat e njerëzve dhe projekteve, përshkrimet e fushave të përgjegjësisë - dhe një mori njohurish të tjera që ndoshta i kemi harruar dhe që mund të ruhen në vendet më të mahnitshme.
Njohuri =/= dokumentacion. Kjo nuk mund të shpjegohet, duhet mbajtur mend
Si të siguroheni që ata që duhet të dinë diçka nga kjo të kuptojnë se ku dhe si ta gjejnë atë, dhe të gjithë ata që duhet të jenë të vetëdijshëm për gjërat dhe marrëveshjet individuale mund të mësojnë menjëherë dhe me saktësi për ndryshimet në to.
Në episodin e fundit të podcast "Team Lead Will Call", djemtë nga Skyeng folën për menaxhimin e njohurive me Igor Tsupko është një person në komitetin e programit KnowledgeConf dhe "drejtori i të panjohurës" në Flant.
Regjistrimi i plotë është i disponueshëm si , dhe më poshtë kemi mbledhur disa këshilla interesante dhe lidhje me materiale të dobishme që u përmendën në audio ose zgjeroni informacionin prej tij. Do të ishte mirë nëse ndani edhe mashtrimet dhe truket e ekipit tuaj në komente.
Hakimi i parë: nuk keni më nevojë të dini se në cilin sistem të shikoni
"Unë mora burimet tona të njohurive dhe bëra një kërkim të përgjithshëm për to: një dritare të vetme me një sistem filtri për të zvogëluar zonën e kërkimit. Po, në të njëjtën kohë, ju ende duhet të monitoroni cilësinë e tij, të rimbushni bazën e njohurive dhe të luftoni dyfishimin dhe informacionin e gabuar.
Një copë letër për të gjetur vetëm kaq
Por tashmë, rreth 60% e inxhinierëve Flant e përdorin këtë kërkim të paktën 1-2 herë në ditë - dhe zakonisht gjejnë përgjigje në pozicionet e para ose të dyta. Dhe në formën e provës së konceptit është indeksimi i dokumenteve të Google: të gjitha dox-et, dosjet, disqet e furgonit, e kështu me radhë - e gjithë kjo gjithashtu futet lehtësisht në kërkimin e brendshëm."
Hakimi i dytë: si të mos humbisni gjëra kritike të rëndësishme në një mori bisedash
“Nëse punoni në një ekip të shpërndarë, atëherë ndoshta një pjesë e konsiderueshme e ditës suaj kalon në Slack - dhe në këtë rast jeni mësuar të bëni diçka të tillë: “@myteam, ndihmoni/shikoni/futni atë të duhurin… ”.” Por ka një problem me bollëkun e informacionit - dhe një përmendje e veçantë mund të mungojë midis mesazheve të tjera.
Në Skyeng ne ndihmohemi nga një bot përmes të cilit mund të shkruani një mesazh dhe të etiketoni çdo numër njerëzish ose grupesh. Ne e përdorim atë në rastet kur është me të vërtetë e rëndësishme që njerëzit të lexojnë ose të reagojnë: do të trokasë pafund derisa të shtypni butonin "Unë lexova" - nuk do të jeni në gjendje ta kaloni ose ta shpërfillni."
Pyetja për t'u përgjigjur: çfarë të bëni me dokumentacionin?
“Shumë njohuri vijnë nga teknikët, por jo të gjithë dinë ta përshkruajnë mirë.
Në fund të fundit, ju nuk keni ndonjë përpilues ose linter që do t'ju tregonte nëse po e bëni mirë apo jo - dhe shpesh dalja që kemi është tekst i pakuptueshëm, i formatuar dobët dhe i paplotë. Sigurisht, ju duhet ta bëni atë normalisht, jo sepse dikush erdhi dhe tha "është e nevojshme" - ju e bëni mirë për veten tuaj: në një ose dy muaj do ta lexoni dhe do ta kuptoni. Dhe një person tjetër, duke hapur një dokument, nuk do ta mbyllë menjëherë përgjithmonë, duke kuptuar se është i padobishëm.
Një pjesë e podcast-it kushtuar pyetjes "Sa njerëz duhen për të shkruar një dokumentacion të mirë ose për të bërë një demonstrim normal"
Por pyetja mbetet: sa kohë duhet ndarë për këtë dhe si ta bëjmë atë në mënyrë efikase?
Dhe nëse ka një përgjigje të sinqertë këtu: nëse njerëzit e biznesit nuk janë të përfshirë dhe nëse ata nuk përjetojnë në mënyrë empirike ndikimin e dokumentacionit të mirë, ekziston rreziku që përpjekjet të japin pak kthim. Kjo është më shumë një histori për ndryshimin e kulturës.
Për pjesën tjetër, përvoja dhe mentorimi do t'ju shpëtojnë. Analogët e programimit të çifteve, ndjekja e progresit dhe rishikimet e kodit mund të jenë të përshtatshme këtu - duke treguar praktikat më të mira, duke u futur në gabime dhe në fund të mërzitshme."
Bonusi: "Mirë, do t'u them kështu, ata do ta kuptojnë"
Pyetja "sa kohë duhet shpenzuar për këtë dhe në çfarë niveli për ta bërë atë" është e rëndësishme jo vetëm në kuadrin e dokumentacionit, por në përgjithësi për transferimin e çdo njohurie. Demoja është gjithashtu një shembull i shkëlqyer i shkëmbimit të informacionit. Por ka nuanca: për shembull, si të siguroheni që të marrin kohë minimale.
Kanali i ndarjes së njohurive midis zhvillimit: raporte të brendshme, libra të dobishëm, artikuj, etj. Ekstrakti i strukturuar ruhet gjithashtu në Notion.
Pjesërisht, këto probleme mund të zgjidhen me praktikën e raporteve të brendshme. Një herë në javë, 40-60 minuta merren në një kohë më pak të ngarkuar - dhe djemtë bëjnë një raport video për kolegët nga projekte të ndryshme. Ekipi frontend i produktit kryesor - Vimbox - rreth kompletit tuaj të UI, i cili mund të jetë i temës për çdo projekt tjetër. Ekipi i zhvillimit të marketingut foli për një bibliotekë për gjurmimin dhe regjistrimin e kërkesave, e cila tërhoqi menjëherë interesin e disa projekteve të tjera. Ekipi i projektit të Matematikës ndau përvojën e tyre të kalimit nga REST API në GraphQL. Ekipi i mësimeve në grup po mendon të ndajë se si ata ishin të parët që kaluan në PHP 7.4. Dhe kështu me radhë.
Lista është mbajtur që nga maji 2018 dhe ka mbi 120 hyrje
Të gjitha takimet nisen përmes Google Meet të korporatës, regjistrohen dhe brenda 1.5 orëve shfaqen në një dosje në një disk të përbashkët të Google dhe lidhjet me regjistrimet dublikohen në të njëjtin Slack. Kjo do të thotë, nuk duhet të vini nëse ka një urgjencë, por shikojeni më vonë me shpejtësi 20 - zakonisht vetë raporti zgjat deri në XNUMX minuta, dhe diskutimi - si rezulton. Por ne nuk shkojmë përtej orës)
PS Çfarë funksionoi dhe nuk funksionoi për ju?
Lidhje të dobishme:
- Rodion Nagornov nga Kaspersky Lab rreth dhe pse ky nuk është dokumentacion (faleminderit kanalit të Igor për lidhjen , ka shumë të tjera të tilla).
- Igor Tsupko nga Flant për këtë në shoqërinë time
- Alexey Kataev nga Skyeng (boshllëqet e njohurive në teknologji dhe fusha specifike) në një ekip të shpërndarë.
- Sergey Goncharuk nga Flant në lidhje me përcjelljen e informacionit - , nëse hasni një problem në një ekip të shpërndarë.
Burimi: www.habr.com