Priemerná IT spoločnosť má požiadavky, históriu sledovačov úloh, zdrojový kód (možno aj s komentármi v kóde), pokyny pre typické, dôležité a zložité prípady použitia v produkcii, popis obchodných procesov (od nástupu až po „ako ísť na dovolenku“), kontakty, prístupové kľúče, zoznamy ľudí a projektov, popis oblastí zodpovednosti – a kopu ďalších vedomostí, na ktoré sme pravdepodobne zabudli a ktoré sa dajú uložiť na tých najprekvapivejších miestach.
Vedomosti =/= dokumentácia. Nedajú sa vysvetliť, musia sa zapamätať.
Ako môžeme zabezpečiť, aby tí, ktorí o tom niečo potrebujú vedieť, rozumeli, kde a ako to nájsť, a aby sa každý, kto potrebuje byť informovaný o konkrétnych veciach a dohodách, mohol okamžite a presne dozvedieť o ich zmenách?
V záverečnej epizóde podcastu „Team Lead Will Call“ sa chalani zo Skyengu rozprávali s Igorom o manažmente znalostí Tsupko je členom programového výboru KnowledgeConf a „riaditeľom neznámeho“ vo Flante.
Celý záznam je k dispozícii ako Nižšie sme zostavili niekoľko zaujímavých tipov a odkazov na užitočné zdroje, ktoré boli spomenuté v audiozázname alebo rozširujú informácie v ňom obsiahnuté. Boli by sme radi, keby ste sa s nami v komentároch podelili o triky a triky vášho tímu.
Hack 1: Už nemusíte vedieť, v ktorom systéme vyhľadávať
„Vzal som naše zdroje vedomostí a vytvoril som pre ne jednotný vyhľadávací nástroj: jedno okno s filtrovacím systémom na zúženie rozsahu vyhľadávania. Áno, zároveň musíme stále monitorovať jeho kvalitu, rozširovať vedomostné bázy a bojovať proti duplicite a chybným informáciám.“
Jeden strojček na toto všetko
Ale už teraz približne 60 % inžinierov spoločnosti Flant používa toto vyhľadávanie aspoň raz alebo dvakrát denne – a zvyčajne nájdu odpovede na prvej alebo druhej pozícii. A ako dôkaz konceptu máme indexovanie Dokumentov Google: všetky dokumenty, priečinky, jednotlivé disky atď. – toto všetko sa dá ľahko integrovať aj do interného vyhľadávania.“
Hack č. 2: Ako sa vyhnúť prehliadnutiu dôležitých informácií v dave chatov
Ak pracujete v distribuovanom tíme, pravdepodobne trávite značnú časť dňa v Slacku – a keď sa niečo stane, zvyknete hovoriť veci ako „@môj tím, pomôžte/pozrite sa na toto/napíšte relevantné informácie...“. Existuje však problém s preťažením informáciami – a konkrétna zmienka sa môže medzi ostatnými správami ľahko prehliadnuť.
V Skyeng používame bota, ktorý vám umožňuje napísať správu a označiť ľubovoľný počet ľudí alebo skupín. Používame ho, keď je naozaj dôležité, aby si ju ľudia prečítali alebo reagovali: kliká, kým nekliknete na tlačidlo „Prečítal som si“ – nemôžete ho preskočiť ani ignorovať.
Záludná otázka: čo robiť s dokumentáciou?
„Veľa vedomostí pochádza od technikov, ale nie každý ich vie dobre opísať.“
Koniec koncov, nemáte kompilátor ani linter, ktorý by vám povedal, či to robíte správne – a výstup je často nezrozumiteľný, zle naformátovaný a neúplný. Samozrejme, nemali by ste to robiť správne, pretože niekto iný povedal „musíte“ – robíte si láskavosť: o mesiac alebo dva si to prečítate a pochopíte to. A niekto iný neotvorí dokumentáciu a okamžite ju navždy nezatvorí, uvedomujúc si, že je bezcenná.
Epizóda podcastu, ktorá sa zaoberá otázkou „Koľko ľudí je potrebných na napísanie dobrej dokumentácie alebo vytvorenie slušnej demoverzie?“.
Otázkou však zostáva: koľko času by sa na to malo vyhradiť a ako to možno urobiť efektívne?
A úprimná odpoveď znie: pokiaľ nie sú podnikatelia zapojení a empiricky nepocítia výhody dobrej dokumentácie, existuje riziko, že toto úsilie prinesie len malý vplyv. Ide skôr o zmenu kultúry.
V opačnom prípade vás zachránia skúsenosti a mentorstvo. Párové programovanie, sledovanie pokroku a kontroly kódu môžu byť tu užitočné – demonštrácia osvedčených postupov, poukázanie na chyby a v konečnom dôsledku aj otravovanie.“
Bonus: „No tak, poviem im to, pochopia to.“
Otázka „koľko času by som mal na to stráviť a na akej úrovni by som to mal robiť?“ je dôležitá nielen pre účely dokumentácie, ale pre akýkoľvek prenos znalostí vo všeobecnosti. Demoverzie sú tiež skvelým príkladom výmeny informácií. Existujú však určité nuansy: napríklad ako ich čo najviac časovo náročne stráviť.
Kanál na zdieľanie znalostí pre vývojový tím: interné správy, užitočné knihy, články atď. V Notion je uložené aj štruktúrované zhrnutie.
Tieto problémy sa čiastočne riešia prostredníctvom interných prezentácií. Raz týždenne sa vyhradí 40 – 60 minút mimo špičky, na ktoré členovia tímu prezentujú video prezentáciu kolegom z rôznych projektov. Front-endový tím pre kľúčový produkt Vimbox... o ich UI kite, ktorý je možné tematicky prispôsobiť pre akýkoľvek iný projekt. Tím pre vývoj marketingu hovoril o knižnici na sledovanie a protokolovanie požiadaviek, ktorá okamžite pritiahla záujem niekoľkých ďalších projektov. Projektový tím „Matematika“ sa podelil o svoje skúsenosti s migráciou z REST API na GraphQL. Tím pre skupinové lekcie plánuje podeliť sa o to, ako boli prví, ktorí migrovali na PHP 7.4. A tak ďalej.
Zoznam sa udržiava od mája 2018 a obsahuje viac ako 120 záznamov.
Všetky stretnutia sú naplánované cez firemný Google Meet, nahrávané a nahrané do zdieľaného priečinka na Disku Google do 24 hodín, pričom odkazy na nahrávky sú zdieľané aj cez Slack. To znamená, že sa nemusíte dostaviť, ak sa ponáhľate, a môžete si ich pozrieť neskôr rýchlosťou 1.5. Samotná prezentácia zvyčajne trvá až 20 minút a diskusia je ponechaná na náhodu. Netrváme však dlhšie ako hodinu.
PS Čo vám fungovalo a čo nie?
Užitočné odkazy:
- Rodion Nagornov zo spoločnosti Kaspersky Lab hovorí o... a prečo táto dokumentácia nie je dostupná (vďaka Igorovmu kanálu za odkaz) , je toho oveľa viac).
- Igor Tsupko z Flantu o tom, že v mojej spoločnosti
- Alexey Kataev zo Skyengu (medzery vo vedomostiach v technológiách a špecifických oblastiach) v distribuovanom tíme.
- Sergej Gončaruk z Flantu o poskytovaní informácií , ak narazíte na problém v distribuovanom tíme.
Zdroj: hab.com
