আমি ক্রমবর্ধমান ওপেন সোর্স প্রকল্পের নির্মাতা। বর্তমানে, ডকুমেন্টেশন পরিচালনা করার সেরা উপায়টি বের করার চেষ্টা করে আমি হিমশিম খাচ্ছি। আমি বিবেচনা করেছি বিকল্পগুলি এখানে:
- এইচটিএমএল ওয়েবসাইট
- একটি গিথুব উইকি
- মার্কডাউন ফাইলগুলি গিথুব-এ হোস্ট করা হয়েছে
- সমস্ত ডক্স গিথুব README.md এ স্থাপন করা হচ্ছে
ডকুমেন্টেশনটি ইতিমধ্যে মার্কডাউনে লেখা আছে, আমি কীভাবে এটি উপলব্ধ করতে চাই তা বুঝতে পারি না। আমি সত্যিই গিতের দিকে টানছি যেহেতু আমি ডকুমেন্টেশনটি শাখা এবং ট্যাগ করতে পারি ঠিক যেমন আমি উত্সটি শাখা এবং ট্যাগ করতে পারি।
আমি মার্কডাউন লাইব্রেরিটি মার্কডাউনটি এইচটিএমএলে অনুবাদ করতে এবং এটি স্টাইলযুক্ত ওয়েবসাইটে প্রদর্শন করতে পারি। যে কোনও সময় পরিবর্তন আসার পরে আমার ওয়েবসাইটে পরিবর্তনগুলি আপলোড করতে হবে এবং ডকুমেন্টেশনের বিভিন্ন "ট্যাগ" এর সমস্ত পরিচালনা করা কঠিন হবে।
গিথুব উইকিস (যতদূর আমি জানি) আপনি যে শাখায় রয়েছেন সে অনুযায়ী পরিবর্তন হয় না। সুতরাং, আমি যে কোনও সময়ে গিথুব উইকি ফর্মে ডকুমেন্টেশনের কেবলমাত্র "মাস্টার" সংস্করণটি পেতে পারি।
এটিকে সমস্ত গিথুব রিডেমে রাখার বিষয়টি খুব সুন্দর at আমি ব্রাঞ্চিং এবং ট্যাগিং পেয়েছি তবে এটি ব্যবহার করতে একটু ক্লান্তি লাগছে এবং সহজে নেভিগেশনে নিজেকে ভাল ধার দেয় না।
আমি কি কিছু দুর্দান্ত সমাধান মিস করছি? আমার আর কোন বিকল্প নেই?