Mae gan y cwmni TG cyffredin ofynion, hanes o dracwyr tasgau, cod ffynhonnell (o bosibl hyd yn oed gyda sylwadau yn y cod), cyfarwyddiadau ar gyfer achosion defnydd cynhyrchu nodweddiadol, pwysig a chymhleth, disgrifiad o brosesau busnes (o ymsefydlu i "sut i fynd ar wyliau"), cysylltiadau, allweddi mynediad, rhestrau o bobl a phrosiectau, disgrifiad o feysydd cyfrifoldeb—a llond llaw o wybodaeth arall yr ydym wedi'i hanghofio amdani, yn ôl pob tebyg, a gellir ei storio yn y lleoedd mwyaf annisgwyl.
Gwybodaeth =/= dogfennaeth. Ni ellir ei hesbonio, rhaid ei chofio.
Sut allwn ni sicrhau bod y rhai sydd angen gwybod rhywbeth am hyn yn deall ble a sut i ddod o hyd iddo, a bod pawb sydd angen cael gwybod am bethau a chytundebau penodol yn gallu dysgu ar unwaith ac yn gywir am newidiadau iddynt?
Yn y bennod olaf o bodlediad “Team Lead Will Call”, siaradodd y dynion o Skyeng am reoli gwybodaeth gydag Igor. Mae Tsupko yn aelod o bwyllgor rhaglen KnowledgeConf ac yn “gyfarwyddwr yr anhysbys” yn Flant.
Mae'r recordiad llawn ar gael fel Isod, rydym wedi llunio rhai awgrymiadau diddorol a dolenni i adnoddau defnyddiol a grybwyllwyd yn y sain neu sy'n ehangu ar y wybodaeth sydd ynddynt. Byddem wrth ein bodd pe baech yn rhannu triciau a thriciau eich tîm yn y sylwadau.
Hac 1: Nid oes angen i chi wybod pa system i chwilio ynddi mwyach
"Cymerais ein ffynonellau gwybodaeth a chreu peiriant chwilio unedig ar eu cyfer: un ffenestr gyda system hidlo i gulhau cwmpas y chwiliad. Ydy, ar yr un pryd, mae angen i ni fonitro ei ansawdd o hyd, ehangu'r cronfeydd gwybodaeth, a mynd i'r afael â dyblygu a gwybodaeth anghywir."
Un clipiwr i ddod o hyd i hyn i gyd
Ond eisoes, mae tua 60% o beirianwyr Flant yn defnyddio'r chwiliad hwn o leiaf unwaith neu ddwywaith y dydd—ac fel arfer yn dod o hyd i atebion yn y safle cyntaf neu'r ail. Ac fel prawf o'r cysyniad, mae gennym fynegeio Google Docs: pob dogfen, ffolder, un gyriant, ac yn y blaen—gellir integreiddio hyn i gyd yn hawdd i'r chwiliad mewnol hefyd.
Hac 2: Sut i Osgoi Colli Gwybodaeth Hanfodol mewn Torf o Sgyrsiau
Os ydych chi'n gweithio mewn tîm dosbarthedig, mae'n debyg eich bod chi'n treulio rhan sylweddol o'ch diwrnod yn Slack—a phan fydd rhywbeth yn digwydd, rydych chi wedi arfer dweud pethau fel, "@myteam, helpwch/edrychwch ar hyn/teipiwch y wybodaeth berthnasol..." Ond mae problem gorlwytho gwybodaeth—a gall sôn penodol gael ei golli'n hawdd ymhlith negeseuon eraill.
Yn Skyeng, rydym yn defnyddio bot sy'n gadael i chi ysgrifennu neges a thagio unrhyw nifer o bobl neu grwpiau. Rydym yn ei ddefnyddio pan mae'n wirioneddol bwysig i bobl ddarllen neu ymateb: mae'n parhau i glicio nes i chi glicio'r botwm "Rydw i wedi darllen"—ni allwch ei hepgor na'i anwybyddu.
Cwestiwn anodd: beth i'w wneud â'r ddogfennaeth?
“Mae llawer o wybodaeth yn dod gan bobl dechnegol, ond nid yw pawb yn gallu ei disgrifio’n dda.
Wedi'r cyfan, does gennych chi ddim cyfieithydd na linter i ddweud wrthych chi a ydych chi'n ei wneud yn iawn—ac yn aml mae'r allbwn yn annealladwy, wedi'i fformatio'n wael, ac yn anghyflawn. Wrth gwrs, ni ddylech chi ei wneud yn iawn oherwydd bod rhywun arall wedi dweud "mae'n rhaid i chi"—rydych chi'n gwneud ffafr i chi'ch hun: ymhen mis neu ddau, byddwch chi'n ei ddarllen ac yn ei ddeall. Ac ni fydd rhywun arall yn agor y ddogfennaeth ac yn ei chau ar unwaith am byth, gan sylweddoli ei bod yn ddiwerth.
Y bennod podlediad, sy'n mynd i'r afael â'r cwestiwn "Faint o bobl sydd eu hangen i ysgrifennu dogfennaeth dda neu wneud demo gweddus?"
Ond mae'r cwestiwn yn parhau: faint o amser y dylid ei ddyrannu ar gyfer hyn a sut gellir ei wneud yn effeithlon?
A'r ateb gonest yma yw: oni bai bod pobl fusnes yn cymryd rhan ac yn profi manteision dogfennu da yn empirig, mae risg na fydd yr ymdrechion hyn yn cynhyrchu llawer o effaith. Mae'n ymwneud mwy â newid diwylliant.
Fel arall, bydd profiad a mentora yn eich achub. Gall rhaglennu pâr, olrhain cynnydd, ac adolygiadau cod fod yn ddefnyddiol yma—dangos arferion gorau, tynnu sylw at wallau, ac, yn y pen draw, cwyno.
Bonws: “O, dewch ymlaen, mi ddywedaf hyn wrthyn nhw, byddan nhw’n deall.”
Mae'r cwestiwn "faint o amser ddylwn i ei dreulio ar hyn ac ar ba lefel ddylwn i ei wneud?" yn bwysig nid yn unig at ddibenion dogfennu ond ar gyfer unrhyw drosglwyddo gwybodaeth yn gyffredinol. Mae demos hefyd yn enghraifft wych o gyfnewid gwybodaeth. Ond mae yna rai manylion: er enghraifft, sut i'w gwneud mor amser-gymerol â phosibl.
Sianel rhannu gwybodaeth ar gyfer y tîm datblygu: adroddiadau mewnol, llyfrau defnyddiol, erthyglau, ac ati. Mae crynodeb strwythuredig hefyd wedi'i storio yn Notion.
Mae'r problemau hyn yn cael eu datrys yn rhannol drwy gyflwyniadau mewnol. Unwaith yr wythnos, neilltuir 40-60 munud yn ystod oriau tawel, ac mae aelodau'r tîm yn cyflwyno cyflwyniad fideo i gydweithwyr o wahanol brosiectau. Y tîm blaen ar gyfer y cynnyrch allweddol, Vimbox, am eu pecyn UI, y gellir ei themau ar gyfer unrhyw brosiect arall. Siaradodd y tîm datblygu marchnata am lyfrgell ar gyfer olrhain a chofnodi ceisiadau, a ddenodd ddiddordeb sawl prosiect arall ar unwaith. Rhannodd tîm prosiect "Mathemateg" eu profiad o fudo o API REST i GraphQL. Mae'r tîm gwersi grŵp yn bwriadu rhannu sut nhw oedd y cyntaf i fudo i PHP 7.4. Ac yn y blaen.
Mae'r rhestr wedi cael ei chynnal ers mis Mai 2018 ac mae'n cynnwys dros 120 o gofnodion.
Mae pob cyfarfod yn cael ei drefnu drwy Google Meet corfforaethol, ei recordio, a'i uwchlwytho i ffolder Google Drive a rennir o fewn 24 awr, gyda dolenni i'r recordiadau hefyd yn cael eu rhannu drwy Slack. Mae hyn yn golygu nad oes rhaid i chi ymddangos os ydych chi ar frys a gallwch wylio'n ddiweddarach ar gyflymder 1.5. Mae'r cyflwyniad ei hun fel arfer yn para hyd at 20 munud, ac mae'r drafodaeth yn cael ei gadael i siawns. Dydyn ni ddim yn mynd y tu hwnt i awr, serch hynny.
PS Beth weithiodd a beth na weithiodd i chi?
Dolenni defnyddiol:
- Mae Rodion Nagornov o Kaspersky Lab yn siarad am a pham nad yw'r ddogfennaeth hon (diolch i sianel Igor am y ddolen) , mae llawer mwy fel 'na).
- Igor Tsupko o Flant am y ffaith, yn fy nghwmni
- Alexey Kataev o Skyeng (bylchau gwybodaeth mewn technolegau a meysydd penodol) mewn tîm dosbarthedig.
- Sergey Goncharuk o Flant ar gyflwyno gwybodaeth , os byddwch chi'n dod ar draws problem mewn tîm dosbarthedig.
Ffynhonnell: hab.com
