Ang karaniwang kumpanya ng IT ay may mga kinakailangan, isang kasaysayan ng mga tagasubaybay ng gawain, mga mapagkukunan (marahil kahit na may mga komento sa code), mga tagubilin para sa tipikal, mahalaga at kumplikadong mga kaso sa produksyon, isang paglalarawan ng mga proseso ng negosyo (mula sa onboarding hanggang sa "kung paano magbakasyon β), mga contact, mga access key, mga listahan ng mga tao at proyekto, mga paglalarawan ng mga lugar ng responsibilidad - at isang bungkos ng iba pang kaalaman na malamang na nakalimutan namin at maaaring maimbak sa mga pinakakahanga-hangang lugar.
Kaalaman =/= dokumentasyon. Hindi ito maipaliwanag, dapat itong tandaan
Paano matiyak na ang mga kailangang malaman mula dito ay nauunawaan kung saan at kung paano ito mahahanap, at lahat ng kailangang magkaroon ng kamalayan sa mga indibidwal na bagay at kasunduan ay maaaring agad at tumpak na malaman ang tungkol sa mga pagbabago sa mga ito.
Sa huling yugto ng podcast ng "Team Lead Will Call", ang mga lalaki mula sa Skyeng ay nagsalita tungkol sa pamamahala ng kaalaman kasama si Igor Si Tsupko ay isang tao sa KnowledgeConf program committee at ang "director of the unknown" sa Flant.
Ang buong pag-record ay magagamit bilang , at sa ibaba ay nakolekta namin ang ilang mga kawili-wiling tip at link sa mga kapaki-pakinabang na materyales na binanggit sa audio o palawakin ang impormasyon mula dito. Magiging mahusay kung ibabahagi mo rin ang mga hack at trick ng iyong koponan sa mga komento.
Unang hack: hindi mo na kailangang malaman kung aling sistema ang titingnan
βKinuha ko ang aming mga pinagmumulan ng kaalaman at gumawa ng pangkalahatang paghahanap para sa mga ito: isang window na may sistema ng pag-filter upang bawasan ang lugar ng paghahanap. Oo, sa parehong oras, kailangan mo pa ring subaybayan ang kalidad nito, lagyang muli ang base ng kaalaman, at labanan ang pagdoble at maling impormasyon.
Isang pirasong papel para hanapin iyon lang
Ngunit ngayon, humigit-kumulang 60% ng mga inhinyero ng Flant ang gumagamit ng paghahanap na ito nang hindi bababa sa 1-2 beses sa isang araw - at kadalasang nakakahanap ng mga sagot sa una o pangalawang posisyon. At sa anyo ng patunay ng konsepto ay ang pag-index ng mga dokumento ng Google: lahat ng mga dox, folder, van drive, at iba pa - lahat ng ito ay madaling madala sa panloob na paghahanap."
Pangalawang hack: kung paano hindi makaligtaan ang mga kritikal na mahahalagang bagay sa isang grupo ng mga chat
"Kung nagtatrabaho ka sa isang ipinamahagi na koponan, malamang na isang makabuluhang bahagi ng iyong araw ang ginugol sa Slack - at kung saan nakasanayan mong gawin ang isang bagay na tulad nito: "@myteam, tumulong/tumingin/ipasok ang tama... β.β Ngunit may problema sa kasaganaan ng impormasyon - at ang isang hiwalay na pagbanggit ay maaaring makaligtaan sa iba pang mga mensahe.
Sa Skyeng kami ay tinutulungan ng isang bot kung saan maaari kang magsulat ng mensahe at mag-tag ng anumang bilang ng mga tao o grupo. Ginagamit namin ito sa mga kaso kung saan talagang mahalaga na magbasa o mag-react ang mga tao: ito ay walang katapusan hanggang sa pindutin mo ang "Nabasa ko" na buton - hindi mo ito magagawang laktawan o balewalain."
Tanong na sasagutin: ano ang gagawin sa dokumentasyon?
"Maraming kaalaman ang nagmumula sa mga techies, ngunit hindi lahat ay alam kung paano ito ilarawan nang maayos.
Pagkatapos ng lahat, wala kang anumang compiler o linter na magsasabi sa iyo kung ginagawa mo ito ng tama o hindi - at kadalasan ang output na mayroon kami ay hindi maintindihan, hindi maganda ang format at hindi kumpletong teksto. Siyempre, kailangan mong gawin ito nang normal, hindi dahil may dumating at nagsabing "kailangan" - ginagawa mo ito nang maayos para sa iyong sarili: sa isang buwan o dalawa ay babasahin mo ito at mauunawaan. At ang isa pang tao, na nagbubukas ng isang dokumento, ay hindi kaagad isasara ito magpakailanman, napagtatanto na ito ay walang silbi.
Bahagi ng podcast na nakatuon sa tanong na "Ilang tao ang kailangan upang magsulat ng magandang dokumentasyon o gumawa ng isang normal na demo"
Ngunit ang tanong ay nananatili: gaano karaming oras ang ilalaan para dito at kung paano ito gagawin nang mahusay?
At kung mayroong isang matapat na sagot dito: maliban kung ang mga tao sa negosyo ay kasangkot, at maliban kung sila ay empirically nararanasan ang epekto ng mahusay na dokumentasyon, may panganib na ang pagsisikap ay magbubunga ng maliit na kita. Ito ay higit na kwento tungkol sa pagbabago ng kultura.
Para sa natitira, ang karanasan at mentoring ay magliligtas sa iyo. Maaaring angkop dito ang mga analogue ng pares programming, pagsubaybay sa pag-unlad at mga pagsusuri sa code - nagpapakita ng mga pinakamahuhusay na kagawian, nagsusundot sa mga error at nakakainip sa huli."
Bonus: "Okay, sasabihin ko sa kanila sa ganitong paraan, maiintindihan nila"
Ang tanong na "gaano karaming oras ang gugugol dito at sa anong antas gawin ito" ay mahalaga hindi lamang sa loob ng balangkas ng dokumentasyon, ngunit sa pangkalahatan para sa paglipat ng anumang kaalaman. Ang demo ay isa ring magandang halimbawa ng pagbabahagi ng impormasyon. Ngunit may mga nuances: halimbawa, kung paano tiyakin na tumatagal sila ng kaunting oras.
Channel ng pagbabahagi ng kaalaman sa pag-unlad: mga panloob na ulat, kapaki-pakinabang na aklat, artikulo, atbp. Ang structured extract ay nakaimbak din sa Notion.
Sa bahagi, ang mga problemang ito ay malulutas sa pamamagitan ng pagsasagawa ng mga panloob na ulat. Minsan sa isang linggo, 40-60 minuto ang kinukuha sa hindi gaanong abalang oras - at ang mga lalaki ay gumagawa ng isang ulat ng video para sa mga kasamahan mula sa iba't ibang mga proyekto. Frontend team ng pangunahing produkto - Vimbox - tungkol sa iyong UI kit, na maaaring maging tema para sa anumang iba pang proyekto. Ang marketing development team ay nag-usap tungkol sa isang library para sa pagsubaybay at pag-log ng mga kahilingan, na agad na nakakuha ng interes ng ilang iba pang mga proyekto. Ibinahagi ng koponan ng proyekto ng Matematika ang kanilang karanasan sa paglipat mula sa REST API patungo sa GraphQL. Ang pangkat ng mga aralin sa pangkat ay nag-iisip na ibahagi kung paano sila ang unang lumipat sa PHP 7.4. At iba pa.
Ang listahan ay pinanatili mula noong Mayo 2018 at mayroong higit sa 120 mga entry
Sinisimulan ang lahat ng meeting sa pamamagitan ng corporate Google Meet, naitala at sa loob ng 1.5 na oras ay lalabas sa isang folder sa isang shared Google drive, at ang mga link sa mga recording ay duplicate sa parehong Slack. Ibig sabihin, hindi mo kailangang pumunta kung may emergency, ngunit panoorin ito sa ibang pagkakataon sa bilis na 20 - kadalasan ang ulat mismo ay tumatagal ng hanggang XNUMX minuto, at ang talakayan - kung paano ito lumalabas. Ngunit hindi kami lumampas sa oras)
PS Ano ang nagtrabaho at hindi gumana para sa iyo?
Mga kapaki-pakinabang na link:
- Rodion Nagornov mula sa Kaspersky Lab tungkol sa at bakit hindi ito dokumentasyon (salamat sa channel ni Igor para sa link , marami pang ganyan).
- Igor Tsupko mula sa Flant tungkol diyan sa aking kumpanya
- Alexey Kataev mula sa Skyeng (mga puwang ng kaalaman sa mga teknolohiya at mga partikular na lugar) sa isang distributed team.
- Sergey Goncharuk mula sa Flant tungkol sa paghahatid ng impormasyon - , kung makatagpo ka ng problema sa isang distributed team.
Pinagmulan: www.habr.com