Batez besteko IT enpresak baditu eskakizunak, zereginen jarraitzaileen historia, iturburu-kodea (baliteke kodean iruzkinak ere izatea), ekoizpen-erabilera kasu tipiko, garrantzitsu eta konplexuetarako argibideak, negozio-prozesuen deskribapena (hasieratik "nola joan oporretara" arte), kontaktuak, sarbide-giltzak, pertsonen eta proiektuen zerrendak, erantzukizun-eremuen deskribapena —eta ziurrenik ahaztu ditugun eta leku harrigarrienetan gorde daitezkeen beste hainbat ezagutza.
Ezagutza =/= dokumentazioa. Ezin da azaldu, buruz ikasi behar da.
Nola ziurtatu dezakegu honi buruz zerbait jakin behar dutenek non eta nola aurkitu dezaketen ulertzen dutela, eta gauza eta akordio zehatzei buruz informatuta egon behar duten guztiek berehala eta zehatz-mehatz jakin ahal izatea horien aldaketen berri?
“Team Lead Will Call” podcastaren azken atalean, Skyeng-eko mutilek ezagutza kudeaketaz hitz egin zuten Igorrekin. Tsupko KnowledgeConf programa batzordeko kidea eta Flant-eko “ezezagunaren zuzendaria” da.
Grabaketa osoa eskuragarri dago honela: Jarraian, audioan aipatutako baliabide erabilgarrietarako aholku interesgarri batzuk eta estekak bildu ditugu, edo bertan jasotako informazioa zabaltzen dute. Zure taldearen trikimailuak eta trikimailuak iruzkinetan partekatzea gustatuko litzaiguke.
1. trikimailua: Jada ez duzu jakin behar zein sistematan bilatu behar duzun
"Gure ezagutza iturriak hartu eta bilaketa-motor bateratu bat sortu nuen haientzat: leiho bakarra, bilaketa-eremua murrizteko iragazketa-sistema batekin. Bai, aldi berean, oraindik ere haren kalitatea kontrolatu behar dugu, ezagutza-baseak zabaldu eta bikoiztasunari eta informazio okerrari aurre egin behar diogu."
Klipa bakarra hau guztia aurkitzeko
Baina dagoeneko, Flant-eko ingeniarien % 60 inguruk bilaketa hau erabiltzen dute egunean behin edo bitan gutxienez, eta normalean erantzunak lehenengo edo bigarren posizioan aurkitzen dituzte. Eta kontzeptuaren froga gisa, Google Docs indexazioa dugu: dokumentu, karpeta, unitate bakarreko unitate eta abar guztiak; hori guztia barne bilaketan ere erraz integra daiteke.
2. trikimailua: Nola saihestu informazio kritikoa galtzea txat jendetza batean
Talde banatu batean lan egiten baduzu, ziurrenik eguneko zati handi bat Slack-en ematen duzu, eta zerbait gertatzen denean, ohituta zaude honelako gauzak esatera: "@niretaldea, lagundu/begira ezazu hau/idatzi informazio garrantzitsua...". Baina informazio gehiegi izatearen arazoa dago, eta aipamen zehatz bat erraz gal daiteke beste mezuen artean.
Skyengen, mezu bat idazteko eta nahi adina pertsona edo talde etiketatzeko aukera ematen dizun bot bat erabiltzen dugu. Jendeak irakurtzea edo erreakzionatzea benetan garrantzitsua denean erabiltzen dugu: klik egiten jarraitzen du "Irakurri dut" botoia sakatu arte; ezin duzu saltatu edo alde batera utzi.
Galdera korapilatsua: zer egin dokumentazioarekin?
«Ezagutza asko teknologiariengandik dator, baina ezin du edonork ondo deskribatu.»
Azken finean, ez duzu konpiladore edo linterrik ondo egiten ari zaren esateko —eta askotan irteera ulertezina, gaizki formatua eta osatugabea da. Noski, ez zenuke ondo egin behar beste norbaitek "egin behar duzu" esan duelako— mesede bat egiten ari zara zeure buruari: hilabete edo bi barru, irakurri eta ulertuko duzu. Eta beste norbaitek ez du dokumentazioa irekiko eta berehala itxiko betiko, baliorik ez duela konturatuz.
Podcast atala, "Zenbat pertsona behar dira dokumentazio ona idazteko edo demo duin bat egiteko?" galderari heltzen diona.
Baina galdera hor dago: zenbat denbora eskaini behar zaio horretarako eta nola egin daiteke modu eraginkorrean?
Eta erantzun zintzoa hauxe da: enpresaburuak inplikatuta ez badaude eta dokumentazio onaren onurak enpirikoki bizi ez badituzte, ahalegin horiek eragin txikia izateko arriskua dago. Kultura aldatzea da kontua.
Bestela, esperientziak eta tutoretzak salbatuko zaituzte. Bikoteka programatzea, aurrerapenaren jarraipena eta kodearen berrikuspenak lagungarriak izan daitezke hemen: jardunbide egokiak erakutsiz, akatsak adieraziz eta, azken finean, kexatuz.
Gehigarria: «Tira, tira, hau esango diet, ulertuko dute».
"Zenbat denbora eman behar diot honi eta zein mailatan egin behar dut?" galdera ez da soilik dokumentazio helburuetarako garrantzitsua, baizik eta oro har edozein ezagutza transferentziarako. Demoak ere informazio trukearen adibide bikaina dira. Baina badaude ñabardura batzuk: adibidez, nola egin ahalik eta denbora gehien kontsumitzeko.
Garapen-taldearentzako ezagutza partekatzeko kanal bat: barne-txostenak, liburu erabilgarriak, artikuluak, etab. Laburpen egituratu bat ere gordetzen da Notion-en.
Arazo hauek neurri batean barne aurkezpenen bidez konpontzen dira. Astean behin, 40-60 minutu gordetzen dira ordu puntatik kanpo, eta taldekideek bideo-aurkezpen bat egiten diete hainbat proiektutako lankideei. Vimbox produktu nagusiaren aurrealdeko taldeak, beren UI kit-ari buruz, beste edozein proiektutarako gaia izan daitekeena. Marketin garapen taldeak eskaerak jarraitzeko eta erregistratzeko liburutegi bati buruz hitz egin zuen, eta horrek beste hainbat proiekturen interesa piztu zuen berehala. "Matematika" proiektu taldeak REST API batetik GraphQL-ra migratzeko esperientzia partekatu zuen. Taldeko ikasgaien taldeak PHP 7.4-ra migratzen lehenak izan zirela partekatzeko asmoa du. Eta abar.
Zerrenda 2018ko maiatzetik mantentzen da eta 120 sarrera baino gehiago ditu.
Bilera guztiak enpresaren Google Meet bidez programatzen dira, grabatu eta 24 orduko epean Google Drive karpeta partekatu batera igotzen dira, grabazioen estekak Slack bidez ere partekatzen direlarik. Horrek esan nahi du ez duzula bertara joan beharrik presaka bazaude eta geroago 1.5eko abiaduran ikus dezakezula. Aurkezpenak berak normalean 20 minutu irauten du, eta eztabaida zoriaren esku uzten da. Hala ere, ez dugu ordubete baino gehiago irauten.
PS Zerk funtzionatu zuen eta zerk ez zuen funtzionatu zuretzat?
Esteka erabilgarriak:
- Rodion Nagornov Kaspersky Labeko kideak honi buruz hitz egiten du eta zergatik ez da dokumentazio hau (eskerrik asko Igorren kanalari estekagatik) , horrelako askoz gehiago daude).
- Igor Tsupko Flantetik honako hauei buruz: nire enpresan
- Alexey Kataev Skyeng-etik (teknologietan eta arlo espezifikoetan ezagutza hutsuneak) talde banatu batean.
- Sergey Goncharuk Flantetik informazioa helarazteari buruz , talde banatu batean arazoren bat baduzu.
Iturria: www.habr.com
