سوالی که بعد از مقایسه دانشنامه با Wiki سنتی مطرح میشود
در مقاله مقایسه دانشنامه با Knowledge Base سنتی گفتیم دانشنامه لایهای روی اسناد موجود است، نه جایگزین آنها. اما در عمل، بیشتر تیمهای فنی فقط یک سیستم مستندسازی ندارند — بخشی در Confluence است، بخشی در Readme فایلهای Git، و بخشی هم فقط در فایلهای Word یا Markdown محلی روی سیستم یک نفر. سوال بعدی طبیعی است: دانشنامه چطور روی این پراکندگی واقعی، نه یک سیستم واحد و مرتب، تنظیم میشود؟
چرا این پراکندگی برای تیمهای فنی طبیعی است
این وضعیت، استثنا نیست، قاعده است. مستندسازی فنی معمولاً بهمرور زمان و در ابزارهای مختلف شکل میگیرد — یک بخش در دوران استفاده از یک ابزار قدیمی نوشته شده، بخش دیگر بعد از مهاجرت به ابزار جدید، و بخشی هم هرگز بهطور رسمی جابهجا نشده. تیمهایی که سراغ اجایل رفتهاند هم معمولاً مستندسازی را در حداقل ممکن نگه میدارند، که نتیجهاش پراکندگی و ناقص بودن اسناد در چند نقطه است. راهحل واقعی این نیست که همه را یکجا کنیم — که خودش یک پروژه بزرگ و پرریسک است — بلکه این است که یک لایه جستوجو روی همان پراکندگی موجود بگذاریم.
قدم اول: نقشهبرداری از منابع موجود، نه یکسانسازی آنها
اولین اشتباه رایج، تلاش برای مهاجرت همه اسناد به یک سیستم واحد پیش از راهاندازی دانشنامه است — کاری که معمولاً ماهها طول میکشد و هرگز کامل نمیشود. بهجای این، فقط فهرستی از منابع موجود تهیه کنید — Confluence، مخازن Git، فایلهای محلی، حتی کانالهای چت که تصمیمات فنی مهم در آنها ثبت شده — بدون اینکه لازم باشد آنها را جابهجا یا یکسان کنید.
قدم دوم: اولویتبندی منابع بر اساس تازگی و کاربرد
همه منابع ارزش یکسان ندارند. اسنادی که هنوز فعالانه بهروزرسانی میشوند (مثل Readme پروژههای در حال توسعه) باید اولویت اول باشند؛ اسنادی که ماههاست دست نخوردهاند ممکن است قدیمی یا نامعتبر باشند. پیش از اتصال کامل، این منابع را بر اساس تازگی و میزان استفاده واقعی تیم رتبهبندی کنید تا دانشنامه ابتدا از معتبرترین منابع تغذیه شود.
قدم سوم: مشخص کردن تناقضهای احتمالی بین منابع
وقتی مستندات در چند سیستم پراکنده باشند، تناقض بین آنها اجتنابناپذیر است — یک سند قدیمی در Confluence ممکن است پیکربندیای را توضیح دهد که در Readme جدیدتر، متفاوت مستند شده. پیش از راهاندازی کامل، مواردی که میدانید بین منابع تناقض دارند را شناسایی و علامتگذاری کنید، تا دانشنامه بهجای ترکیب نامعتبر دو منبع متناقض، نسخه معتبرتر را در اولویت قرار دهد.