Il-kumpanija tal-IT medja għandha rekwiżiti, storja ta’ trackers tal-kompiti, sorsi (forsi anke b’kummenti fil-kodiċi), struzzjonijiet għal każijiet tipiċi, importanti u kumplessi fil-produzzjoni, deskrizzjoni tal-proċessi tan-negozju (minn onboarding sa “kif tmur vaganza ”) , kuntatti, ċwievet ta’ aċċess, listi ta’ nies u proġetti, deskrizzjonijiet ta’ oqsma ta’ responsabbiltà – u mazz ta’ għarfien ieħor li x’aktarx insew dwaru u li jistgħu jinħażnu fl-aktar postijiet tal-għaġeb.
Għarfien =/= dokumentazzjoni. Dan ma jistax jiġi spjegat, għandu jiġi mfakkar
Kif tiżgura li dawk li għandhom bżonn ikunu jafu xi ħaġa minn dan jifhmu fejn u kif isibuha, u kull min jeħtieġ li jkun konxju ta 'affarijiet u ftehimiet individwali jista' istantanjament u b'mod preċiż isir jaf dwar bidliet fihom.
Fl-episodju finali tal-podcast "Team Lead Will Call", in-nies minn Skyeng tkellmu dwar il-ġestjoni tal-għarfien ma' Igor Tsupko hija persuna fuq il-kumitat tal-programm KnowledgeConf u d-"direttur ta 'l-mhux magħruf" f'Flaunt.
Ir-reġistrazzjoni sħiħa hija disponibbli bħala , u hawn taħt ġbarna xi suġġerimenti interessanti u links għal materjali utli li ssemmew fl-awdjo jew jespandu l-informazzjoni minnu. Ikun kbir jekk taqsam ukoll il-hacks u t-tricks tat-tim tiegħek fil-kummenti.
L-ewwel hack: m'għadx għandek bżonn tkun taf f'liema sistema tfittex fiha
“Ħadt is-sorsi tal-għarfien tagħna u għamilt tfittxija ġenerali għalihom: tieqa waħda b’sistema ta’ filtrazzjoni biex tnaqqas iż-żona tat-tfittxija. Iva, fl-istess ħin, għad trid tissorvelja l-kwalità tagħha, timla l-bażi ta 'għarfien, u tiġġieled id-duplikazzjoni u l-informazzjoni żbaljata.
Biċċa waħda karta biex issib dak kollu
Iżda diġà, madwar 60% tal-inġiniera Flant jużaw din it-tfittxija mill-inqas 1-2 darbiet kuljum - u normalment isibu tweġibiet fl-ewwel jew it-tieni pożizzjoni. U fil-forma ta’ prova ta’ kunċett hemm l-indiċjar ta’ dokumenti ta’ Google: id-doxs, folders, drives tal-vannijiet kollha, eċċ – dan kollu jitmexxa wkoll faċilment fit-tfittxija interna.”
It-tieni hack: kif ma titlifx affarijiet ta 'importanza kritika f'mazz ta' chats
“Jekk taħdem f’tim imqassam, allura probabbilment parti sinifikanti tal-ġurnata tiegħek titqatta’ f’Slack – u f’liema każ tkun imdorri tagħmel xi ħaġa bħal din: “@myteam, għin/ħares/daħħal it-tajjeb... ”.” Iżda hemm problema bl-abbundanza ta 'informazzjoni - u tissemma separata tista' tintilef fost messaġġi oħra.
Fi Skyeng aħna megħjuna minn bot li permezz tiegħu tista 'tikteb messaġġ u ttikketta kull numru ta' nies jew gruppi. Aħna nużawha f'każijiet fejn huwa tassew importanti li n-nies jaqraw jew jirreaġixxu: se toqgħod bla tarf sakemm tagħfas il-buttuna "Naqra" - ma tkunx tista' taqbeż jew tinjoraha."
Mistoqsija biex twieġeb: x'għandek tagħmel bid-dokumentazzjoni?
“Ħafna għarfien ġej mit-teknoloġija, iżda mhux kulħadd jaf kif jiddeskrivih tajjeb.
Wara kollox, m'għandekx xi kompilatur jew linter li jgħidlek jekk qed tagħmilx sew jew le - u ħafna drabi l-output li jkollna huwa test inkomprensibbli, ifformattjat ħażin u mhux komplut. Naturalment, għandek bżonn tagħmel dan b'mod normali, mhux għax xi ħadd ġie u qal "huwa meħtieġ" - tagħmel dan tajjeb għalik innifsek: fi żmien xahar jew tnejn taqrah u tifhem. U persuna oħra, li tiftaħ dokument, ma tagħlaqx immedjatament għal dejjem, billi tirrealizza li hija inutli.
Parti mill-podcast iddedikat għall-mistoqsija "Kemm hemm bżonn nies biex tikteb dokumentazzjoni tajba jew tagħmel demo normali"
Iżda l-mistoqsija tibqa ': kemm talloka ħin għal dan u kif tagħmel dan b'mod effiċjenti?
U jekk hawn tweġiba onesta: sakemm in-nies tan-negozju ma jkunux involuti, u sakemm ma jesperjenzawx b'mod empiriku l-impatt ta' dokumentazzjoni tajba, hemm riskju li l-isforz jagħti ftit qligħ. Din hija aktar storja dwar il-bidla fil-kultura.
Għall-bqija, l-esperjenza u l-mentoring se jiffrankaw. L-analogi tal-ipprogrammar tal-pari, it-traċċar tal-progress u r-reviżjonijiet tal-kodiċi jistgħu jkunu adattati hawn - li juru l-aħjar prattiki, jaqbdu l-iżbalji u fl-aħħar mill-aħħar jittaqqbu.”
Bonus: "Tajjeb, ngħidilhom hekk, jifhmu"
Il-mistoqsija "kemm ħin għandek tqatta 'fuq dan u f'liema livell tagħmel dan" hija importanti mhux biss fil-qafas tad-dokumentazzjoni, iżda b'mod ġenerali għat-trasferiment ta' kwalunkwe għarfien. Id-demo hija wkoll eżempju tajjeb ta’ qsim ta’ informazzjoni. Iżda hemm sfumaturi: pereżempju, kif tiżgura li jieħdu ħin minimu.
Kanal tal-qsim tal-għarfien fost l-iżvilupp: rapporti interni, kotba utli, artikoli, eċċ. L-estratt strutturat huwa maħżun ukoll f'Notion.
Parzjalment, dawn il-problemi jistgħu jissolvew bil-prattika tar-rapporti interni. Darba fil-ġimgħa, 40-60 minuta jittieħdu f'ħin inqas okkupat - u l-guys jagħmlu rapport bil-vidjo għall-kollegi minn proġetti differenti. Tim ta 'frontend tal-prodott ewlieni - Vimbox - dwar il-kit UI tiegħek, li jista 'jkun temat għal kwalunkwe proġett ieħor. It-tim ta 'żvilupp tal-kummerċjalizzazzjoni tkellem dwar librerija għal talbiet ta' traċċar u qtugħ, li immedjatament ġibdet l-interess ta 'bosta proġetti oħra. It-tim tal-proġett tal-Matematika qasmu l-esperjenza tagħhom tal-bidla minn REST API għal GraphQL. It-tim tal-lezzjonijiet tal-grupp qed jaħseb li jaqsam kif kienu l-ewwel li qalbu għal PHP 7.4. U l-bqija.
Il-lista ilha tinżamm minn Mejju 2018 u għandha aktar minn 120 entrata
Il-laqgħat kollha jinbdew permezz ta' Google Meet korporattiv, jiġu rreġistrati u fi żmien 1.5 siegħa jidhru f'folder fuq Google drive kondiviż, u links għar-reġistrazzjonijiet huma duplikati fl-istess Slack. Jiġifieri, m'għandekx għalfejn tiġi jekk ikun hemm emerġenza, imma taraha aktar tard b'veloċità 20 - ġeneralment ir-rapport innifsu jdum sa XNUMX minuta, u d-diskussjoni - kif tirriżulta. Imma ma mmorrux lil hinn mis-siegħa)
PS Dak li ħadem u ma ħadimx għalik?
Ħoloq utli:
- Rodion Nagornov minn Kaspersky Lab dwar u għaliex din mhix dokumentazzjoni (grazzi għall-kanal ta 'Igor għall-link , hemm ħafna aktar bħal dik).
- Igor Tsupko minn Flant dwar dan fil-kumpanija tiegħi
- Alexey Kataev minn Skyeng (lakuni fl-għarfien fit-teknoloġiji u oqsma speċifiċi) f'tim distribwit.
- Sergey Goncharuk minn Flant dwar it-twassil ta' informazzjoni - , jekk tiltaqa' ma' problema f'tim imqassam.
Sors: www.habr.com
