স্পিনক্সের মতো কীভাবে ?
আপনি আপনার ডকুমেন্টেশনগুলি রিস্ট্রাকচার্ড টেক্সটে লিখুন (সিনট্যাক্স মার্কডাউনের অনুরূপ, যা স্ট্যাক ওভারফ্লো ব্যবহার করে) সরল টেক্সট ফাইলগুলিতে (= সংস্করণ নিয়ন্ত্রণে সহজ) এবং স্পিনিক্স এইচটিএমএল পৃষ্ঠাগুলি ছড়িয়ে দেয়।
দুটি সর্বাধিক বিশিষ্ট স্পিংক্স ব্যবহারকারী (যা আমি জানি) হলেন পাইথন ল্যাঙ্গুয়েজ এবং টরটোইসএইচজি (স্পিনেক্স তৈরি হওয়া ডকুমেন্টেশনের লিঙ্কগুলি দেখুন)।
সম্পাদনা করুন:
আমি কেবল পড়েছি যে আপনি প্রকল্পের অভ্যন্তরীণ ডকুমেন্টেশন সম্পর্কে কথা বলছেন, শেষ-ব্যবহারকারী নথিপত্র নয়।
আমার মতে, স্পিনক্সের মতো কিছু হ'ল অভ্যন্তরীণ ডকুমেন্টেশনের জন্যও সেরা উপায় (আপনি আপনার বিশ্লেষকদের পুনর্গঠনপ্রবন্ধটি লিখতে পারেন) তবে এটি:
- আপনি সহজেই দস্তাবেজগুলিকে নিয়ন্ত্রণ করতে পারেন (এবং পাঠ্য ফাইলগুলির বিভিন্নতা বাইনারি ফাইলগুলি .doc বা .pdf এর চেয়ে অনেক কম জায়গা নেয়)।
- যদি কোনও বিকাশকারী একটি দুর্দান্ত পঠনযোগ্য .ডোক বা .pdf ফাইল চান, তবে তিনি উত্স থেকে স্পিনিক্স দিয়ে এটি তৈরি করতে পারেন।
যদি স্ফিংকস খুব জটিল হয় তবে আরও সহজ উপায় আছে: আপনি মার্কডাউনে আপনার ডকুমেন্টেশন লিখতে পারেন এবং প্যান্ডোক ব্যবহার করতে পারেন (উদাহরণস্বরূপ) .rtf, .doc বা .pdf ফাইল (এটি আরও অনেক কিছু করতে পারে)।
স্প্যানিক্সের চেয়ে পান্ডোক শুরু করা সহজ পেয়েছি তবে প্যানডোক স্পিনক্সের মতো সুন্দর মেনু স্তরক্রম তৈরি করতে পারে না (যেমন আমি পাইথন এবং টরটোইসএইচজি ডকুমেন্টেশনের মতো উপরে লিঙ্ক করেছি)।
আপনি কোন সরঞ্জামগুলি ব্যবহার করুন তা বিবেচনাধীন নয়, আপনার যদি কোনও অভ্যন্তরীণ ওয়েব সার্ভার এবং একটি বিল্ড সার্ভার থাকে তবে আপনি এটি সেট আপ করতে পারেন যাতে বিল্ড সার্ভারটি HTML আউটপুট উত্পন্ন করে এবং প্রতিবার ডকুমেন্টেশনে যখন কোনও কিছু চাপ দেয় তখন ওয়েব সার্ভারে এটি অনুলিপি করে। সুতরাং আপনার বিশ্লেষকরা এমনকি চূড়ান্ত আউটপুট সম্পর্কে চিন্তাও করতে হবে না, তাদের কেবল তাদের পরিবর্তনগুলি প্রতিশ্রুতিবদ্ধ এবং ধাক্কা দেওয়া দরকার।