Prosječna IT tvrtka ima zahtjeve, povijest task trackera, izvore (možda čak i s komentarima u kodu), upute za tipične, važne i složene slučajeve u proizvodnji, opis poslovnih procesa (od onboardinga do “kako otići na godišnji odmor” ”), kontakte, pristupne ključeve, popise ljudi i projekata, opise područja odgovornosti - i hrpu drugih znanja na koja smo vjerojatno zaboravili, a koja se mogu pohraniti na najčudesnija mjesta.
Znanje =/= dokumentacija. Ovo se ne može objasniti, to se mora zapamtiti
Kako učiniti da oni koji trebaju znati nešto od ovoga znaju gdje i kako to pronaći, a svi koji moraju biti upoznati s pojedinim stvarima i dogovorima mogu trenutno i točno saznati promjene u njima.
U posljednjoj epizodi podcasta “Team Lead Will Call” dečki iz Skyenga razgovarali su s Igorom o upravljanju znanjem Tsupko je osoba u programskom odboru KnowledgeConfa i “direktor nepoznatog” u Flantu.
Cijela snimka dostupna je kao , au nastavku smo prikupili neke zanimljive savjete i poveznice na korisne materijale koji su spomenuti u audio zapisu ili prošireni podaci iz njega. Bilo bi sjajno da u komentarima podijelite i hakove i trikove svog tima.
Prvi hack: više ne morate znati koji sustav tražite
“Uzeo sam naše izvore znanja i napravio opću pretragu za njima: jedan prozor sa sustavom filtriranja za smanjenje područja pretraživanja. Da, u isto vrijeme i dalje morate pratiti njegovu kvalitetu, nadopunjavati bazu znanja i boriti se protiv dupliciranja i pogrešnih informacija.
Jedan komad papira da nađem to je sve
Ali već oko 60% inženjera Flanta koristi ovu pretragu barem 1-2 puta dnevno – i obično nalaze odgovore na prvoj ili drugoj poziciji. A u obliku dokaza koncepta je indeksiranje Google dokumenata: svi dokumenti, mape, pogoni kombija i tako dalje - sve se to također lako ubacuje u internu pretragu.”
Drugi hack: kako ne propustiti kritično važne stvari u hrpi chatova
“Ako radite u distribuiranom timu, tada vjerojatno značajan dio vašeg dana provodite u Slacku - a u tom slučaju ste navikli raditi nešto poput ovoga: “@myteam, pomozi/pogledaj/unesi pravog... ”.” Ali postoji problem s obiljem informacija - a zasebno spominjanje može izostati među ostalim porukama.
U Skyeng-u nam pomaže bot preko kojeg možete napisati poruku i označiti neograničen broj ljudi ili grupa. Koristimo ga u slučajevima kada je doista važno da ljudi čitaju ili reagiraju: bockat će se beskonačno sve dok ne pritisnete gumb "Pročitao sam" - nećete ga moći preskočiti ili ignorirati."
Pitanje na koje treba odgovoriti: što učiniti s dokumentacijom?
“Mnogo znanja dolazi od tehničara, ali ne znaju svi kako to dobro opisati.
Naposljetku, nemate nikakav prevodilac ili linter koji bi vam rekao radite li to dobro ili ne - i često je rezultat koji imamo nerazumljiv, loše formatiran i nepotpun tekst. Naravno, morate to učiniti normalno, a ne zato što je netko došao i rekao "tako treba" - učinite to dobro za sebe: za mjesec ili dva ćete to pročitati i shvatiti. A druga osoba, otvarajući dokument, neće ga odmah zatvoriti zauvijek, shvaćajući da je beskoristan.
Dio podcasta posvećen pitanju “Koliko je ljudi potrebno da se napiše dobra dokumentacija ili napravi normalan demo”
Ali ostaje pitanje: koliko vremena izdvojiti za to i kako to učiniti učinkovito?
I ako ovdje postoji pošten odgovor: ako poslovni ljudi nisu uključeni i ako empirijski ne iskuse učinak dobre dokumentacije, postoji rizik da će se trud uroditi malim povratom. Ovo je više priča o promjeni kulture.
Za ostalo će vas spasiti iskustvo i mentorstvo. Ovdje bi mogli biti prikladni analozi programiranja u paru, praćenja napretka i pregleda koda - pokazujući najbolje prakse, bockajući se po pogreškama i dosadeći na kraju.”
Bonus: "Dobro, ovako ću im reći, razumjet će"
Pitanje "koliko vremena utrošiti na to i na kojoj razini to učiniti" važno je ne samo u okviru dokumentacije, već općenito za prijenos bilo kakvog znanja. Demo je također izvrstan primjer dijeljenja informacija. Ali postoje nijanse: na primjer, kako osigurati da zauzimaju minimalno vrijeme.
Kanal dijeljenja znanja među razvojem: interna izvješća, korisne knjige, članci itd. Strukturirani ekstrakt također je pohranjen u Notionu.
Dijelom se ti problemi mogu riješiti praksom internih izvješća. Jednom tjedno odvoji se 40-60 minuta u manje užurbano vrijeme - i dečki naprave video reportažu za kolege iz različitih projekata. Frontend tim ključnog proizvoda - Vimbox - o vašem UI kompletu, koji se može tematizirati za bilo koji drugi projekt. Tim za razvoj marketinga govorio je o knjižnici za praćenje i bilježenje zahtjeva, što je odmah privuklo interes nekoliko drugih projekata. Matematički projektni tim podijelio je svoje iskustvo prelaska s REST API-ja na GraphQL. Tim za grupne lekcije razmišlja o tome kako su oni prvi prešli na PHP 7.4. I tako dalje.
Popis se vodi od svibnja 2018. i ima preko 120 unosa
Svi sastanci pokreću se putem korporativnog Google Meeta, snimaju se i u roku od 1.5 sata pojavljuju se u mapi na zajedničkom Google disku, a veze na snimke dupliciraju se u istom Slacku. Odnosno, ne morate dolaziti ako je hitno, ali gledajte kasnije u brzini od 20 - obično samo izvješće traje do XNUMX minuta, a rasprava - kako ispadne. Ali ne idemo dalje od sata)
PS Što vam je uspjelo, a što nije?
Korisni linkovi:
- Rodion Nagornov iz Kaspersky Laba o i zašto ovo nije dokumentacija (hvala Igorovom kanalu za vezu , ima još puno toga).
- O tome Igor Tsupko iz Flanta u mom društvu
- Alexey Kataev iz Skyenga (nedostaci znanja u tehnologijama i određenim područjima) u distribuiranom timu.
- Sergey Goncharuk iz Flanta o prenošenju informacija - , ako naiđete na problem u distribuiranom timu.
Izvor: www.habr.com