یک شرکت فناوری اطلاعات متوسط نیازمندی‌ها، سابقه ردیاب‌های وظایف، منابع (شاید حتی با نظرات در کد)، دستورالعمل‌هایی برای موارد معمول، مهم و پیچیده در تولید، شرح فرآیندهای کسب‌وکار (از ورود به سیستم تا «نحوه رفتن به تعطیلات» است. ”)، مخاطبین، کلیدهای دسترسی، لیست افراد و پروژه ها، شرح حوزه های مسئولیت - و دسته ای از دانش های دیگر که احتمالا آنها را فراموش کرده ایم و می توانند در شگفت انگیزترین مکان ها ذخیره شوند.
دانش =/= مستندات. این را نمی توان توضیح داد، باید به خاطر داشت
Как сделать так, чтобы те, кому понадобилось узнать что-то из этого, понимали, где и как это найти, а все, кому нужно быть в курсе отдельных вещей и договоренностей, моментально и точно могли узнать об изменениях в них.
در قسمت آخر پادکست "سرب تیم تماس خواهد گرفت"، بچه های Skyeng در مورد مدیریت دانش با ایگور صحبت کردند. تسوپکو فردی در کمیته برنامه KnowledgeConf و "مدیر ناشناخته ها" در فلانت است.
ضبط کامل به عنوان موجود است و در زیر نکات و پیوندهای جالبی را به مطالب مفیدی که در صوت ذکر شده و یا اطلاعات آن را بسط داده اند جمع آوری کرده ایم. عالی خواهد بود اگر هک ها و ترفندهای تیم خود را نیز در نظرات به اشتراک بگذارید.
هک اول: دیگر نیازی نیست بدانید که در کدام سیستم باید جستجو کنید
من منابع دانش خود را گرفتم و یک جستجوی کلی برای آنها انجام دادم: یک پنجره واحد با یک سیستم فیلتر برای کاهش منطقه جستجو. بله، در عین حال، شما همچنان باید کیفیت آن را کنترل کنید، پایگاه دانش را دوباره پر کنید و با اطلاعات تکراری و اشتباه مبارزه کنید.
یک تکه کاغذ برای پیدا کردن همین
اما در حال حاضر، حدود 60٪ از مهندسان Flant حداقل 1-2 بار در روز از این جستجو استفاده می کنند - و معمولاً پاسخ ها را در موقعیت های اول یا دوم پیدا می کنند. و در قالب اثبات مفهوم، نمایه سازی اسناد Google است: همه داکس ها، پوشه ها، درایوهای ون و غیره - همه اینها نیز به راحتی در جستجوی داخلی هدایت می شوند.
Второй хак: как не упустить критично-важное в куче чатов
"اگر در یک تیم توزیع شده کار می کنید، احتمالاً بخش قابل توجهی از روز شما در Slack سپری می شود - و در این صورت شما به انجام چنین کاری عادت دارید: "@myteam، کمک/نگاه کنید/یک مورد مناسب را وارد کنید... ”.” اما یک مشکل با فراوانی اطلاعات وجود دارد - و ذکر جداگانه ای را می توان در میان پیام های دیگر از دست داد.
در Skyeng توسط یک ربات به ما کمک می کند که از طریق آن می توانید یک پیام بنویسید و هر تعداد از افراد یا گروه ها را تگ کنید. ما از آن در مواردی استفاده می‌کنیم که واقعاً مهم است که مردم بخوانند یا واکنش نشان دهند: تا زمانی که دکمه «خواندم» را فشار دهید بی‌وقفه به صدا در می‌آید - نمی‌توانید آن را نادیده بگیرید یا نادیده بگیرید.
سوال برای پاسخ: با مستندات چه باید کرد؟
بسیاری از دانش‌ها از فناوران می‌آیند، اما همه نمی‌دانند چگونه آن را به خوبی توصیف کنند.
از این گذشته، شما هیچ کامپایلر یا خطی ندارید که به شما بگوید آیا این کار را درست انجام می‌دهید یا نه - و اغلب خروجی ما غیرقابل درک، قالب بندی ضعیف و متن ناقص است. البته، شما باید این کار را به طور معمول انجام دهید، نه به این دلیل که کسی آمد و گفت "لازم است" - شما این کار را به خوبی برای خودتان انجام می دهید: در یک یا دو ماه آن را خواهید خواند و متوجه خواهید شد. و شخص دیگری با باز کردن یک سند، بلافاصله آن را برای همیشه نمی بندد و متوجه می شود که بی فایده است.
بخشی از پادکست به این سوال اختصاص دارد که "چند نفر برای نوشتن مستندات خوب یا ساخت یک نسخه نمایشی معمولی نیاز دارند"
اما این سوال باقی می ماند: چقدر زمان برای این کار اختصاص داده می شود و چگونه می توان آن را به طور موثر انجام داد؟
و اگر در اینجا یک پاسخ صادقانه وجود داشته باشد: مگر اینکه افراد تجاری درگیر باشند، و مگر اینکه به طور تجربی تأثیر مستندات خوب را تجربه کنند، این خطر وجود دارد که تلاش ها بازده کمی داشته باشد. این بیشتر یک داستان در مورد تغییر فرهنگ است.
А в остальном, вас спасут опыт и наставничество. Тут могут подойти аналоги парного программирования, трекинга прогресса и код-ревью — показ лучших практик, тыкание в ошибки и нудение в конце концов”.
پاداش: "باشه، من به آنها می گویم، آنها متوجه خواهند شد"
این سؤال که "چه مقدار زمان برای این کار صرف شود و در چه سطحی انجام شود" نه تنها در چارچوب اسناد، بلکه به طور کلی برای انتقال هر دانش مهم است. نسخه ی نمایشی نیز نمونه ای عالی از اشتراک گذاری اطلاعات است. اما تفاوت های ظریف وجود دارد: به عنوان مثال، چگونه می توان مطمئن شد که آنها حداقل زمان را می گیرند.
Канал обмена знаниями среди разработки: внутренние доклады, полезные книги, статьи и т.д. Структурированная выжимка также хранится в Notion.
تا حدودی می توان این مشکلات را با تمرین گزارش های داخلی حل کرد. یک بار در هفته، 40-60 دقیقه در زمان شلوغ کمتر گرفته می شود - و بچه ها یک گزارش تصویری برای همکاران پروژه های مختلف تهیه می کنند. تیم فرانت‌اند محصول کلیدی - Vimbox - در مورد کیت UI شما، که می تواند برای هر پروژه دیگری مضمون باشد. تیم توسعه بازاریابی در مورد کتابخانه ای برای ردیابی و ثبت درخواست ها صحبت کردند که بلافاصله مورد توجه چندین پروژه دیگر قرار گرفت. تیم پروژه ریاضیات تجربه خود را از تغییر از REST API به GraphQL به اشتراک گذاشتند. تیم دروس گروهی در فکر به اشتراک گذاشتن این موضوع است که چگونه اولین کسانی بودند که به PHP 7.4 تغییر مکان دادند. و غیره.
این فهرست از ماه می 2018 حفظ شده است و بیش از 120 ورودی دارد
همه جلسات از طریق Google Meet شرکتی شروع می شوند، ضبط می شوند و ظرف 1.5 ساعت در یک پوشه در درایو مشترک Google ظاهر می شوند و پیوندهای ضبط شده در همان Slack کپی می شوند. یعنی اگر شرایط اضطراری وجود داشته باشد، لازم نیست بیایید، اما بعداً آن را با سرعت 20 تماشا کنید - معمولاً خود گزارش تا XNUMX دقیقه طول می کشد و بحث - چگونه نتیجه می شود. اما ما از ساعت فراتر نمی رویم)
PS چه چیزی برای شما مفید بود و چه چیزی برای شما کار نکرد؟
پیوندهای مفید:
- رودیون ناگورنوف از آزمایشگاه کسپرسکی درباره و چرا این مستند نیست (با تشکر از کانال ایگور برای پیوند , там еще много такого).
- Игорь Цупко из Фланта про то, у себя в компании
- الکسی کاتایف از Skyeng (شکاف های دانش در فن آوری ها و حوزه های خاص) در یک تیم توزیع شده.
- سرگئی گونچاروک از فلانت در مورد انتقال اطلاعات - , если столкнулся с проблемой в распределенной команде.
منبع: www.habr.com