Орташа IT-компанияның талаптары, тапсырмаларды қадағалау тарихы, дереккөздер (мүмкін, кодтағы түсініктемелері бар), өндірістегі типтік, маңызды және күрделі жағдайларға арналған нұсқаулар, бизнес-процестердің сипаттамасы (борттан бастап «демалысқа қалай баруға болады) дейін. ”), контактілер, кіру кілттері, адамдар мен жобалар тізімдері, жауапкершілік аймақтарының сипаттамасы - және біз ұмытып кеткен және ең таңғажайып жерлерде сақталуы мүмкін басқа да көптеген білімдер.
Білім =/= құжаттама. Мұны түсіндіру мүмкін емес, оны есте сақтау керек
Бұдан бірдеңені білуі керек адамдар оны қайдан және қалай табуға болатынын түсінетініне қалай көз жеткізуге болады, ал жеке заттар мен келісімдерден хабардар болуы керек әрбір адам олардағы өзгерістер туралы бірден және дәл біле алады.
«Команда жетекшісі шақырады» подкастының соңғы бөлімінде Skyeng жігіттері Игорьмен білімді басқару туралы сөйлесті. Цупко - KnowledgeConf бағдарламасы комитетіндегі адам және Фланттағы «белгісіздердің директоры».
Толық жазба ретінде қол жетімді , және төменде біз аудиода айтылған немесе ондағы ақпаратты кеңейтетін пайдалы материалдарға бірнеше қызықты кеңестер мен сілтемелерді жинадық. Түсініктемелерде өзіңіздің командаңыздың айла-амалдарымен бөліссеңіз жақсы болар еді.
Бірінші бұзу: енді қай жүйеге кіру керектігін білудің қажеті жоқ
«Мен біздің білім көздерін алып, олар үшін жалпы іздеу жасадым: іздеу аймағын азайту үшін сүзу жүйесі бар жалғыз терезе. Иә, сонымен бірге оның сапасын қадағалап, білім қорын толықтырып, қайталану мен қате ақпаратпен күресу керек.
Барлығын табу үшін бір парақ қағаз
Бірақ қазірдің өзінде Flant инженерлерінің шамамен 60% бұл іздеуді күніне кемінде 1-2 рет пайдаланады және әдетте бірінші немесе екінші позицияларда жауап табады. Тұжырымдаманың дәлелі ретінде Google құжаттарын индекстеу болып табылады: барлық докстар, қалталар, фургон дискілері және т.б. - мұның бәрі ішкі іздеуге оңай түседі.
Екінші бұзу: көптеген чаттардағы маңызды нәрселерді қалай өткізіп алмау керек
«Егер сіз бөлінген командада жұмыс істесеңіз, күніңіздің көп бөлігі Slack-те өтуі мүмкін - және бұл жағдайда сіз келесідей нәрсені жасауға дағдыланғансыз: «@myteam, көмектесіңіз/қараңыз/дұрыс біреуін енгізіңіз... ”.” Бірақ ақпараттың көптігінде мәселе бар - және басқа хабарламалар арасында бөлек ескертуді өткізіп жіберуге болады.
Skyeng-те бізге хабар жазуға және кез келген адамдарды немесе топтарды белгілеуге болатын бот көмектеседі. Біз оны адамдардың оқуы немесе әрекет етуі өте маңызды болған жағдайда пайдаланамыз: ол «Мен оқыдым» түймесін басқанша үздіксіз соғылады - оны өткізіп жіберу немесе елемеу мүмкін емес.
Жауап беретін сұрақ: құжаттамамен не істеу керек?
«Көп білім техникадан келеді, бірақ оны жақсы сипаттауды бәрі бірдей біле бермейді.
Ақыр соңында, сізде оны дұрыс істеп жатқаныңызды немесе орындамағаныңызды көрсететін компилятор немесе линтер жоқ - және бізде жиі шығарылатын нәтиже түсініксіз, нашар пішімделген және толық емес мәтін болып табылады. Әрине, мұны біреу келіп, «бұл қажет» деп емес, әдеттегідей істеу керек - сіз мұны өзіңіз үшін жақсы жасайсыз: бір-екі айдан кейін сіз оны оқып, түсінесіз. Ал басқа адам құжатты аша отырып, оның пайдасыз екенін түсініп, оны бірден мәңгілікке жаппайды.
«Жақсы құжаттама жазу немесе қалыпты демонстрация жасау үшін қанша адам қажет» деген сұраққа арналған подкасттың бір бөлігі.
Бірақ сұрақ қалады: бұған қанша уақыт бөлу керек және оны қалай тиімді орындау керек?
Егер бұл жерде шынайы жауап болса: егер іскер адамдар қатыспаса және олар жақсы құжаттаманың әсерін эмпирикалық түрде сезінбесе, күш-жігердің аз табыс әкелу қаупі бар. Бұл мәдениетті өзгерту туралы көбірек әңгіме.
Қалған жағдайда тәжірибе мен тәлімгерлік сізді құтқарады. Мұнда жұптық бағдарламалаудың, орындалу барысын бақылаудың және кодты шолудың аналогтары қолайлы болуы мүмкін - ең жақсы тәжірибелерді көрсету, қателерді іздеу және соңында жалықтыру».
Бонус: «Жарайды, мен оларға осылай айтамын, олар түсінеді»
«Бұған қанша уақыт жұмсау керек және оны қандай деңгейде орындау керек» деген сұрақ тек құжаттама шеңберінде ғана емес, жалпы алғанда кез келген білімді беру үшін маңызды. Сондай-ақ демонстрация ақпарат алмасудың тамаша үлгісі болып табылады. Бірақ нюанстар бар: мысалы, олардың ең аз уақытты алатындығына қалай көз жеткізуге болады.
Даму арасында білім алмасу арнасы: ішкі есептер, пайдалы кітаптар, мақалалар және т.б. Құрылымдық үзінді де Notion ішінде сақталады.
Ішінара бұл мәселелерді ішкі есеп беру тәжірибесі арқылы шешуге болады. Аптасына бір рет 40-60 минут бос емес уақытта алынады - ал жігіттер әртүрлі жобалардағы әріптестеріне бейне есеп жасайды. Негізгі өнімнің Frontend командасы - Vimbox - кез келген басқа жоба үшін тақырыптық болуы мүмкін UI жинағы туралы. Маркетингті әзірлеу тобы бірден бірнеше басқа жобалардың қызығушылығын тудырған сұрауларды іздеуге және тіркеуге арналған кітапхана туралы айтты. Математика жобасының командасы REST API-ден GraphQL-ге ауысу тәжірибесімен бөлісті. Топтық сабақтар тобы PHP 7.4 нұсқасына бірінші болып қалай ауысқаны туралы бөлісуді ойлайды. Тағыда басқа.
Тізім 2018 жылдың мамыр айынан бері жүргізіліп келеді және 120-дан астам жазба бар
Барлық кездесулер корпоративтік Google Meet арқылы басталады, жазылады және 1.5 сағат ішінде ортақ Google дискісіндегі қалтада пайда болады және жазбаларға сілтемелер бірдей Slack ішінде көшіріледі. Яғни, төтенше жағдай орын алса, келудің қажеті жоқ, бірақ оны кейінірек 20 жылдамдықпен қараңыз - әдетте есептің өзі XNUMX минутқа дейін созылады, ал талқылау - бұл қалай болады. Бірақ біз сағаттан аспаймыз)
PS Сізге не жұмыс істеді және не істемеді?
Пайдалы сілтемелер:
- Касперский зертханасынан Родион Нагорнов туралы және неге бұл құжаттама емес (сілтеме үшін Игорь арнасына рахмет , тағы да көп нәрсе бар).
- Бұл туралы Фланттан Игорь Цупко менің компаниямда
- Skyeng-тен Алексей Катаев (технологиялардағы және нақты салалардағы білім кемшіліктері) бөлінген топта.
- Фланттан Сергей Гончарук ақпаратты жеткізу туралы - , егер сіз бөлінген топта мәселеге тап болсаңыз.
Ақпарат көзі: www.habr.com