আমাদের পরিবেশের জন্য আমাদের পক্ষে যুক্তিসঙ্গতভাবে ভাল ডকুমেন্টেশন রয়েছে (AsciiDoc ফর্ম্যাটে) যা সম্প্রতি অন্য একজনকে 30 মিনিটেরও কম সময়ে স্ক্র্যাচ থেকে পুরো সেটআপটি পুনরায় তৈরি করতে দেয়।
তবে, আমি লক্ষ্য করেছি যে প্রাথমিক সেটআপের পরে, এটি সহজেই ঘটে যায় যে সিস্টেমে ছোট ছোট পরিবর্তন হয়েছে (বলুন: ইনড্ড অক্ষম হয়ে যায়, আমার আইএমএপি সার্ভার ম্যানেজসিভ সংযোগগুলির জন্য একটি অতিরিক্ত পোর্টে শোনেন, এক্সিম কনফিগারেশনে একটি নতুন রাউটার যুক্ত হয়েছে) ডন তাত্ক্ষণিকভাবে ডকুমেন্টেশনে শেষ হবে না (যদি তা হয়)।
এই লাগাতে হতে পারে বাস্তবায়ন এক উপায় - আমার ধারণা দ্বারা (? আংশিকভাবে) এই সমস্যা এড়ানোর কনফিগারেশন ফাইল থেকে বের ডকুমেন্টেশন এবং তাতে মন্তব্য উৎপাদিত ছিল /etcএবং /usr/local/etcকিছু সোর্স কোড ব্যবস্থাপনা সিস্টেমের মধ্যে (বলুন - Git) এবং তারপর একটি রান স্ক্রিপ্ট যা প্রতিটি প্রতিশ্রুতিতে ডকুমেন্টেশন পুনরায় জেনারেট করে। তবে, আমি নিশ্চিত নই যে এটি ওভারকিল এবং / অথবা সঠিকভাবে পাওয়া খুব কঠিন হবে (সর্বোপরি, আমি আমার ডকুমেন্টেশনে উত্স ফাইলগুলির সম্পূর্ণ অনুলিপিগুলি চাই না বরং কেবল ভিন্নতাগুলি চাই)।
অন্যান্য লোকেরা কীভাবে এড়ানো যায় যে সার্ভারের ডকুমেন্টেশনগুলি পুরানো হয়ে যায় - এগুলি স্বয়ংক্রিয়ভাবে সিঙ্কে রাখার কোনও ভাল উপায় আছে বা সিস্টেমটি একই সময়ে পরিবর্তন করার সাথে সাথে ডকুমেন্টেশন আপডেট করার জন্য আপনার কেবল শৃঙ্খলা রয়েছে?