Batez besteko informatika-enpresak eskakizunak ditu, zereginen jarraitzaileen historia, iturriak (agian kodean iruzkinak dituztenak), produkzioko kasu tipiko, garrantzitsu eta konplexuetarako argibideak, negozio prozesuen deskribapena (harreratik "nola joan oporretaraino". β) , kontaktuak, sarbide-giltzak, pertsona eta proiektuen zerrendak, ardura-eremuen deskribapenak - eta ziurrenik ahaztu ditugun beste hainbat ezagutza eta leku harrigarrienetan gorde daitezkeenak.
Ezagutza =/= dokumentazioa. Hau ezin da azaldu, gogoratu behar da
Nola ziurtatu hortik zerbait jakin behar dutenek ulertzen dutela non eta nola aurkitu, eta banakako gauza eta akordioen berri izan behar duten guztiek berehala eta zehatz-mehatz jakin dezaketela haien aldaketak.
"Team Lead Will Call" podcast-eko azken atalean, Skyeng-eko mutilek ezagutzaren kudeaketari buruz hitz egin zuten Igorrekin Tsupko KnowledgeConf programako batzordeko pertsona bat da eta Flanteko "ezezagunaren zuzendaria".
Grabaketa osoa eskuragarri dago , eta jarraian audioan aipatzen ziren material baliagarrietarako zenbait aholku eta esteka interesgarri bildu ditugu edo bertatik ateratako informazioa zabaltzeko. Oso ona izango litzateke zure taldearen hack eta trikimailuak iruzkinetan partekatzen badituzu.
Lehenengo hack: jada ez duzu jakin behar zein sistematan begiratu behar duzun
Β«Gure ezagutza iturriak hartu eta bilaketa orokor bat egin nuen: bilaketa-eremua murrizteko iragazketa sistema duen leiho bakarra. Bai, aldi berean, oraindik ere bere kalitatea kontrolatu behar duzu, ezagutza-basea berritu eta bikoiztearen eta informazio okerren aurka borrokatzeko.
Hori guztia aurkitzeko paper zati bat
Baina dagoeneko, Flanteko ingeniarien % 60 inguruk bilaketa hau egunero erabiltzen dute gutxienez 1-2 aldiz, eta normalean erantzunak lehen edo bigarren postuetan aurkitzen dituzte. Eta kontzeptuaren froga moduan Google dokumentuen indexazioa dago: dox guztiak, karpetak, furgoneta unitateak, eta abar; hori guztia ere erraz sartzen da barne bilaketara".
Bigarren hackea: nola ez galdu txat mordo batean garrantzi kritikoa duten gauzak
"Banatutako talde batean lan egiten baduzu, seguruenik zure egunaren zati garrantzitsu bat Slack-en igaroko da, eta kasu horretan, horrelako zerbait egitera ohituta zaude: "@nire taldea, lagundu/begiratu/sartu egokia... β.β Baina informazio ugariarekin arazo bat dago, eta beste mezuen artean aparteko aipamen bat galdu daiteke.
Skyeng-en bot batek laguntzen gaitu eta horren bidez mezu bat idatzi eta edozein pertsona edo talde etiketa dezakezu. Jendeak irakurtzea edo erreakzionatzea oso garrantzitsua den kasuetan erabiltzen dugu: "Irakurtzen dut" botoia sakatu arte etengabe jotzen du; ezin izango duzu saltatu edo alde batera utzi".
Erantzun beharreko galdera: zer egin dokumentazioarekin?
Β«Ezagutza asko teknologikoetatik dator, baina denek ez daki ondo deskribatzen.
Azken finean, ez duzu ondo egiten ari zaren ala ez esango dizun konpilatzailerik edo linterrik, eta askotan daukagun irteera testua ulergaitza, gaizki formatua eta osatu gabea da. Noski, normalean egin behar duzu, ez norbait etorri eta "beharrezkoa da" esan duelako; ondo egiten duzu zeure burua: hilabete edo bi barru irakurri eta ulertuko duzu. Eta beste pertsona batek, dokumentu bat irekiz, ez du berehala itxiko betiko, alferrikakoa dela konturatuta.
"Zenbat jende behar da dokumentazio ona idazteko edo demo normal bat egiteko" galderari eskainitako podcast-aren zati bat.
Baina galdera geratzen da: zenbat denbora bideratu honetarako eta nola egin eraginkortasunez?
Eta hemen erantzun zintzorik badago: enpresariak parte hartzen ez badu, eta dokumentazio onaren eragina enpirikoki ezagutu ezean, arriskua dago ahaleginak etekin gutxi ateratzeko. Hau kultura aldatzearen inguruko istorio bat da.
Gainerakoan, esperientziak eta tutoretzak salbatuko zaituzte. Bikoteen programazioaren, aurrerapenaren jarraipenaren eta kodeen berrikuspenaren analogoak egokiak izan daitezke hemen: praktika onenak erakutsiz, akatsak aztertzea eta azkenean aspergarria".
Bonua: "Ados, horrela esango diet, ulertuko dute"
"Horretan zenbat denbora eman eta zein mailatan egin" galdera garrantzitsua da dokumentazioaren esparruan ez ezik, oro har, edozein ezagutzaren transferentziarako. Demoa ere informazioa partekatzeko adibide bikaina da. Baina Γ±abardurak daude: adibidez, nola ziurtatu denbora gutxien hartzen duten.
Garapenaren artean ezagutza partekatzeko kanala: barne-txostenak, liburu erabilgarriak, artikuluak, etab. Egituratutako laburpena Notion-en ere gordetzen da.
Neurri batean, arazo hauek barne-txostenen praktikarekin konpondu daitezke. Astean behin, 40-60 minutu lanpetuta ez dagoen denboran hartzen dira, eta mutilek bideo-erreportaje bat egiten dute proiektu ezberdinetako lankideentzat. Gako produktuaren frontend taldea - Vimbox - zure UI kitari buruz, beste edozein proiektutarako gai izan daitekeena. Marketinaren garapen-taldeak trazadura eta erregistro-eskaerak egiteko liburutegi bati buruz hitz egin zuen, eta berehala beste hainbat proiekturen interesa piztu zuen. Matematika proiektuko taldeak REST APItik GraphQLra pasatzearen esperientzia partekatu zuen. Taldeko ikasgaien taldea PHP 7.4ra aldatzen lehenak nola izan ziren partekatzea pentsatzen ari da. Eta abar.
Zerrenda 2018ko maiatzetik mantendu da eta 120 sarrera baino gehiago ditu
Bilera guztiak Google Meet korporatiboaren bidez hasten dira, grabatzen dira eta 1.5 orduko epean Google disko partekatuko karpeta batean agertzen dira, eta grabazioetarako estekak Slack berean bikoizten dira. Hau da, ez duzu etorri behar larrialdiren bat izanez gero, baina ikusi geroago 20 abiaduran - normalean txostenak berak XNUMX minutu irauten du, eta eztabaida - nola ateratzen den. Baina ez gara ordutik haratago joaten)
PS Zerk funtzionatu zuen eta ez zuen balio?
Esteka erabilgarriak:
- Kaspersky Lab-eko Rodion Nagornov buruz eta zergatik ez den dokumentazioa (esker Igorren kanalari estekagatik , horrelako askoz gehiago dago).
- Flanteko Igor Tsupko horri buruz nire konpainian
- Skyengeko Alexey Kataev (teknologietan eta arlo zehatzetan ezagutza hutsuneak) banatutako talde batean.
- Flanteko Sergey Goncharuk informazioa emateari buruz - , banatutako talde batean arazoren bat aurkitzen baduzu.
Iturria: www.habr.com