টুলিং সম্পর্কে মন্তব্য।
আমরা অনলাইন উইকির চেষ্টা করেছি কিন্তু বেশ কয়েকটি সীমাবদ্ধতা পেয়েছি, যা ব্যক্তিগত স্বাদ হতে পারে তবে ডকুমেন্টের কাঠামো অন্তর্ভুক্ত করে এবং ডকুমেন্টেশন সার্ভারের সাথে সংলগ্নভাবে সমালোচনামূলকভাবে যুক্ত হতে হবে।
সংযুক্ত হওয়া একটি গুরুতর সমস্যা যদি আপনি হয় অফলাইন বা অনসাইটে (স্পষ্টতই আপনি কোনও সুরক্ষিত এসএসএল সংযোগ এবং অন। এর সাথে অনসাইটটি প্রশমিত করতে পারেন))
আমাদের বর্তমান ডকুমেন্টেশন প্রক্রিয়াটি হ'ল:
- স্ট্যাটিক এইচটিএমএল জেনারেটর
- মার্কডাউন সিনট্যাক্স
- বিতরণ সংস্করণ সিস্টেম
ডকুমেন্টেশনের জন্য আমাদের একটি 'ফর্মাল' লেআউট রয়েছে এবং এটি মেনুগুলির কাঠামো সরবরাহ করে (এবং ভিজ্যুয়াল স্টাইলিং সম্পর্কিত সম্পর্কিত সিএসএস ইত্যাদি)
স্ট্যাটিক এইচটিএমএল জেনারেটর
আমরা কিউবিক্যাম্প এবং অন্যান্য বেশ কয়েকটি সরঞ্জামের ভিত্তিতে একটি হাউস স্ট্যাটিক এইচটিএমএল জেনারেটর ব্যবহার করি : পাইগমেন্টস , ডকুমেন্টাল ।
উত্পন্ন পৃষ্ঠাগুলি (না?) স্পষ্টতই কুৎসিত দেখাচ্ছে, কারণ আমাদের বেশিরভাগ / আমাদের সিসাদমিন / প্রোগ্রামাররা জানেন যে নান্দনিকভাবে কী সুন্দর তবে এগুলি তৈরিতে সামগ্রিক সমন্বয়ের অভাব রয়েছে।
তবে এটি অনুমোদিত / আসুন এইচটিএমএল ফর্ম্যাট করার জন্য বা এটি ডাউনলোড করার জন্য 'সার্ভারে কোথায় পাবেন তা নিয়ে চিন্তা না করেই কনফিগারেশন ফাইল, নমুনা স্ক্রিপ্টস, পিডিএফ ইত্যাদি অন্তর্ভুক্ত করি।
এটি যদি এইচটিএমএল না হয় তবে এটি কেবল ফোল্ডারে ফেলে দিন এবং এতে একটি url লিঙ্ক যুক্ত করুন।
এইচটিএমএল বিন্যাসের জন্য 'সম্ভাব্য' কাঠামো সরবরাহ করে, এবং জ্ঞান / সামগ্রী আইটেমগুলির মধ্যে সমালোচনামূলকভাবে 'লিঙ্কিং' সরবরাহ করে (পাশাপাশি বেস কাঠামো প্রক্রিয়া, যেমন মেনু তৈরি করতে সক্ষম হওয়া, বিষয়বস্তুর সারণী ইত্যাদি) HTML এর মাধ্যমে, প্রতিটি ব্যবহারকারী এখন করতে পারেন তাদের মেশিনে একটি ছোট ওয়েব সার্ভার চালান লাইটটিপিডি হোক বা ছোট কিছু হোক বা অ্যাপাচি বা আইআইএসের সাথে পুরোপুরি ফুটিয়ে উঠতে হবে।
আমাদের সমস্ত মেশিনে বেসিক এইচটিএমএল পরিবেশনার ঝোঁক রয়েছে এবং এটি আমাদের জন্য যথেষ্ট ভাল কাজ করে।
মার্কডাউন সিনট্যাক্স।
আমরা আমাদের 'ক্রিয়েটিভ' রসগুলিকে এইচটিএমএল নিয়ে চিন্তা না করেই ডকুমেন্টেশন লিখতে দিতে মার্কডাউন, টেক্সটিশ এবং বা পুনর্গঠিত পাঠ্যের একটি জারজ সংস্করণ ব্যবহার করি।
এর অর্থ প্রত্যেকের নিজের পছন্দসই সম্পাদক (আমি উইন্ডোজ এবং * নিক্সে সিন্টিলা ব্যবহার করি) যখন অন্যরা vi / vim ব্যবহার করে।
বিতরণ সংস্করণ সিস্টেম।
আমরা ব্যবহারকারীদের মধ্যে ডকুমেন্টেশন 'বিতরণ' করতে গিট ব্যবহার করি । ওহ, এবং আমরা এটির সংস্করণ ক্ষমতাও ব্যবহার করি।
আমাদের জন্য মূল সুবিধাটি হ'ল আমরা সকলে সার্ভারের সাথে সংযুক্ত না হয়ে এবং 'সম্পূর্ণ' কাজগুলি প্রকাশ না করেই ডকুমেন্টেশন আপডেট করার কাজ করতে পারি। আমরা সকলে ডকুমেন্টেশনের একই অংশে বা বিভিন্ন অংশে কাজ করতে পারি, বা কেবল তথ্যটি গ্রাস করতে পারি।
ব্যক্তিগতভাবে, ব্লগগুলি উইকির একা ছেড়ে দেওয়া আপডেট করার জন্য সার্ভারের সাথে আবদ্ধ হওয়া আমার ঘৃণা। গিট আমাদের পক্ষে ভাল কাজ করে।
কর্মপ্রবাহ সম্পর্কে মন্তব্য
উইকি জ্ঞান প্রচার / কোডিফিকেশনের "ফ্যাশন" বলে মনে হয় তবে অন্যত্র মন্তব্য করা হিসাবে সমস্ত প্রক্রিয়া বজায় রাখা কঠিন হয়ে যায় এবং আপনার দলগুলির প্রয়োজনীয়তার পক্ষে সর্বোত্তম সমর্থন করে এবং টেকসই হয় এমন সরঞ্জামগুলির মিশ্রণটি পেতে সময় লাগবে।
আরও ভাল সমাধানগুলি সন্ধান করা হবে এবং বাধ্যতামূলক নয়।
