راه‌اندازی و ساختاردهی کانفلوئنس (Confluence)

Confluence به‌ندرت به‌خاطر کمبود قابلیت شکست می‌خورد. به این خاطر شکست می‌خورد که هیچ‌کس نمی‌داند سند را کجا بگذارد و شش ماه بعد هیچ‌کس نمی‌داند کدام نسخه معتبر است.

Space را بر اساس مالکیت بسازید، نه موضوع

وسوسهٔ اول این است که برای هر موضوع یک Space بسازید. نتیجه‌اش این می‌شود که هیچ Spaceای مالک ندارد. قاعدهٔ سالم‌تر: هر Space یک تیم یا یک محصول است و یک نفر مسئولش. موضوع‌ها با Label و درخت صفحات مدیریت می‌شوند، نه با ساختن Space جدید.

چهار قالبی که بیشترین اثر را دارند

1. یادداشت جلسه با سه بخش ثابت: تصمیم‌ها، اقدام‌ها با مسئول و تاریخ، موضوع‌های باز.
2. سند تصمیم برای انتخاب‌هایی که بعداً کسی می‌پرسد «چرا این‌طور شد؟». گزینه‌ها، معیار، تصمیم، پیامد.
3. رویهٔ اجرایی برای کارهای تکرارشدنی. باید طوری نوشته شود که فرد تازه‌وارد بدون پرسیدن انجامش بدهد.
4. راهنمای عیب‌یابی برای پشتیبانی: نشانه، علت احتمالی، اقدام، مسیر ارجاع.

اتصال به Jira

قدرت اصلی Confluence برای یک تیم مهندسی، همان اتصالش به Jira است: نمایش زندهٔ فهرست Issue داخل سند، ساخت Issue از دل یادداشت جلسه، و لینک‌شدن خودکار سند به Issue. وقتی این اتصال درست تنظیم شود، سند دیگر یک فایل مرده نیست.

قاعده‌ای که مستند را زنده نگه می‌دارد

هر صفحهٔ مهم دو چیز دارد: یک مالک و یک تاریخ بازبینی. صفحه‌ای که تاریخ بازبینی‌اش گذشته، با Label علامت می‌خورد و در یک صفحهٔ گزارش دیده می‌شود. این ساده‌ترین مکانیزمی است که جلوی تبدیل Confluence به قبرستان سند را می‌گیرد.