لدى شركة تكنولوجيا المعلومات المتوسطة متطلبات، وتاريخ من أدوات تتبع المهام، ومصادر (ربما حتى مع التعليقات في الكود)، وتعليمات للحالات النموذجية والمهمة والمعقدة في الإنتاج، ووصف للعمليات التجارية (من الإعداد إلى "كيفية الذهاب في إجازة" ") وجهات الاتصال ومفاتيح الوصول وقوائم الأشخاص والمشاريع وأوصاف مجالات المسؤولية - ومجموعة من المعرفة الأخرى التي ربما نسيناها والتي يمكن تخزينها في أكثر الأماكن روعة.
المعرفة =/= التوثيق. لا يمكن تفسير هذا، يجب أن نتذكره
كيفية التأكد من أن أولئك الذين يحتاجون إلى معرفة شيء ما من هذا يفهمون أين وكيف يمكن العثور عليه، ويمكن لأي شخص يحتاج إلى أن يكون على دراية بالأشياء والاتفاقيات الفردية أن يعرف على الفور وبدقة التغييرات التي تطرأ عليها.
في الحلقة الأخيرة من البودكاست "Team Lead Will Call"، تحدث شباب Skyeng عن إدارة المعرفة مع Igor تسوبكو هو أحد أعضاء لجنة برنامج KnowledgeConf و"مدير المجهول" في Flant.
التسجيل الكامل متاح ك ، وقمنا أدناه بجمع بعض النصائح والروابط المثيرة للاهتمام لمواد مفيدة تم ذكرها في الصوت أو توسيع المعلومات منه. سيكون من الرائع أن تشارك أيضًا الحيل والحيل التي يستخدمها فريقك في التعليقات.
الاختراق الأول: لم تعد بحاجة إلى معرفة النظام الذي يجب البحث فيه
“لقد أخذت مصادر معرفتنا وقمت بإجراء بحث عام عنها: نافذة واحدة مع نظام تصفية لتقليل مساحة البحث. نعم، في الوقت نفسه، لا تزال بحاجة إلى مراقبة جودتها، وتجديد قاعدة المعرفة، ومكافحة الازدواجية والمعلومات الخاطئة.
قطعة واحدة من الورق للعثور على هذا كل شيء
ولكن بالفعل، يستخدم حوالي 60٪ من مهندسي Flant هذا البحث على الأقل 1-2 مرات في اليوم - وعادةً ما يجدون الإجابات في المركز الأول أو الثاني. وفي شكل إثبات للمفهوم، تتم فهرسة مستندات Google: جميع المستندات والمجلدات ومحركات الشاحنات وما إلى ذلك - كل هذا يمكن أيضًا دفعه بسهولة إلى البحث الداخلي.
الاختراق الثاني: كيف لا تفوت أشياء بالغة الأهمية في مجموعة من الدردشات
"إذا كنت تعمل في فريق موزع، فمن المحتمل أن تقضي جزءًا كبيرًا من يومك في Slack - وفي هذه الحالة تكون معتادًا على القيام بشيء مثل هذا: "@myteam، ساعد/انظر/أدخل الشخص الصحيح... "." ولكن هناك مشكلة في وفرة المعلومات - ومن الممكن تفويت إشارة منفصلة بين الرسائل الأخرى.
في Skyeng، يتم مساعدتنا من خلال روبوت يمكنك من خلاله كتابة رسالة ووضع علامة على أي عدد من الأشخاص أو المجموعات. نحن نستخدمه في الحالات التي يكون فيها من المهم حقًا أن يقرأ الأشخاص أو يتفاعلوا: سوف يستمر في الضغط إلى ما لا نهاية حتى تضغط على زر "قرأت" - ولن تتمكن من تخطيه أو تجاهله.
سؤال للإجابة: ماذا تفعل بالوثائق؟
"الكثير من المعرفة تأتي من التقنيين، ولكن لا يعرف الجميع كيفية وصفها بشكل جيد.
بعد كل شيء، ليس لديك أي مترجم أو برنامج Linter من شأنه أن يخبرك ما إذا كنت تفعل ذلك بشكل صحيح أم لا - وغالبًا ما تكون المخرجات التي لدينا نصًا غير مفهوم وسييء التنسيق وغير مكتمل. بالطبع، عليك أن تفعل ذلك بشكل طبيعي، ليس لأن شخصًا ما جاء وقال "من الضروري" - فأنت تفعل ذلك جيدًا لنفسك: في غضون شهر أو شهرين ستقرأه وتفهمه. وشخص آخر، فتح مستند، لن يغلقه على الفور إلى الأبد، مدركا أنه عديم الفائدة.
جزء من البودكاست مخصص للسؤال "كم عدد الأشخاص الذين يتطلب الأمر كتابة وثائق جيدة أو تقديم عرض توضيحي عادي"
ولكن يبقى السؤال: ما هو مقدار الوقت الذي يجب تخصيصه لهذا الغرض وكيفية القيام بذلك بكفاءة؟
وإذا كانت هناك إجابة صادقة هنا: ما لم يشارك رجال الأعمال، وما لم يختبروا بشكل تجريبي تأثير التوثيق الجيد، فهناك خطر يتمثل في أن هذه الجهود لن تحقق سوى عائد ضئيل. هذه قصة حول تغيير الثقافة.
أما بالنسبة للباقي، فالخبرة والتوجيه سينقذانك. قد تكون نظائر البرمجة الزوجية، وتتبع التقدم، ومراجعات التعليمات البرمجية مناسبة هنا - حيث تعرض أفضل الممارسات، وتنتقد الأخطاء، وتكون مملة في النهاية.
المكافأة: "حسنًا، سأخبرهم بهذه الطريقة، وسوف يفهمون"
إن السؤال "كم من الوقت يجب إنفاقه على هذا وعلى أي مستوى للقيام بذلك" مهم ليس فقط في إطار التوثيق، ولكن بشكل عام لنقل أي معرفة. يعد العرض التوضيحي أيضًا مثالًا رائعًا لمشاركة المعلومات. ولكن هناك فروق دقيقة: على سبيل المثال، كيفية التأكد من أنها تستغرق الحد الأدنى من الوقت.
قناة لتبادل المعرفة بين التطوير: تقارير داخلية، كتب مفيدة، مقالات، إلخ. يتم أيضًا تخزين المستخلص المنظم في Notion.
ويمكن حل هذه المشكلات جزئيًا من خلال ممارسة التقارير الداخلية. مرة واحدة في الأسبوع، يتم قضاء 40-60 دقيقة في وقت أقل ازدحامًا - ويقوم الرجال بإعداد تقرير فيديو للزملاء من مشاريع مختلفة. فريق الواجهة الأمامية للمنتج الرئيسي - Vimbox - حول مجموعة أدوات واجهة المستخدم الخاصة بك، والتي يمكن تخصيصها لأي مشروع آخر. تحدث فريق تطوير التسويق عن مكتبة لطلبات التتبع والتسجيل، والتي جذبت على الفور اهتمام العديد من المشاريع الأخرى. شارك فريق مشروع الرياضيات تجربته في التحول من REST API إلى GraphQL. يفكر فريق الدروس الجماعية في مشاركة كيف كانوا أول من تحول إلى PHP 7.4. وما إلى ذلك وهلم جرا.
تم الاحتفاظ بالقائمة منذ مايو 2018 وتضم أكثر من 120 إدخالًا
تبدأ جميع الاجتماعات من خلال Google Meet للشركة، ويتم تسجيلها وتظهر في مجلد على محرك Google مشترك خلال 1.5 ساعة، ويتم نسخ روابط التسجيلات في نفس Slack. وهذا يعني أنك لست مضطرًا للحضور إذا كانت هناك حالة طوارئ، ولكن شاهده لاحقًا بسرعة 20 - عادةً ما يستمر التقرير نفسه لمدة تصل إلى XNUMX دقيقة، والمناقشة - كيف ستنتهي. لكننا لا نتجاوز الساعة)
PS ما الذي نجح وما لم ينجح بالنسبة لك؟
روابط مفيدة:
- روديون ناجورنوف من كاسبيرسكي لاب عنه ولماذا لا يعد هذا توثيقًا (بفضل قناة Igor على الرابط ، هناك الكثير من هذا القبيل).
- إيجور تسوبكو من فلانت حول ذلك في شركتي
- أليكسي كاتاييف من Skyeng (فجوات المعرفة في التقنيات ومجالات محددة) في فريق موزع.
- سيرجي جونشاروك من فلانت حول نقل المعلومات - ، إذا واجهت مشكلة في فريق موزع.
المصدر: www.habr.com