রচনা: বিষয় লেখা ও সম্পাদনা

লেখার আগে

শৈলী নিয়ম এবং সংগ্রহস্থলের মূলে spec/conventions.md পড়ুন।
বিষয়টি কোথায় বসে এবং কী নম্বর পাবে তা দেখতে সংগ্রহস্থলের মূলে spec/structure.md দেখুন।

নতুন বিষয় লেখা

পর্ব এবং সেই পর্বের পরবর্তী খালি দশমিক নম্বর বাছুন। নম্বর ধারাবাহিক, তাই নতুন বিষয় সাধারণত তার পর্বের শেষ নম্বরের পরেরটি পায়।
বিষয় টেমপ্লেট থেকে locales/en-gb-oxendict/topics/PP-CC-slug.md (শূন্য-পূরিত, ড্যাশ-বিভক্ত উপসর্গ, যেমন 02-01-...) তৈরি করুন। অক্সফোর্ড বানানে লিখুন (দেখুন spec/oxford-spelling.md); অন্য তিনটি লোকেল কখনো সরাসরি সম্পাদনা করবেন না।
টেমপ্লেট অনুসরণ করে লিখুন। প্রতিটি বিষয়বস্তু বিষয়ে সব বিভাগ লাগে: সারসংক্ষেপ, মূল নীতি, সুপারিশ, ট্রেড-অফ (একটি টেবিলসহ), আলোচনার প্রশ্ন, ক্ষেত্র দৃষ্টিকোণ (স্টার্টআপ, ছোট ব্যবসা, এন্টারপ্রাইজ, সরকার), উদাহরণ (একটি এন্টারপ্রাইজ ও একটি সরকারি), ব্যবসায়িক যুক্তি, অ্যান্টি-প্যাটার্ন, পাঁচ-স্তরের পরিপক্বতা মডেল, আলোচনার ভাবনা, মূল সারকথা এবং তথ্যসূত্র।
হেরফেরের পথ চিহ্নিত করুন। প্রতিটি মেট্রিক-পরিবারের “একটি দল কীভাবে যা মাপে তা উন্নত না করে এই সংখ্যাকে ভালো দেখায়, এবং কোন গার্ডরেল তা ধরে” প্রশ্নের স্পষ্ট উত্তর লাগে (দেখুন বিষয় ১.২)।
শব্দ প্রথম ব্যবহারে সংজ্ঞায়িত করুন। প্রথম উল্লেখে মূল ধারণায় উইকিপিডিয়া লিঙ্ক যোগ করুন, শুধু গদ্যে।
সম্পর্কিত বিষয় দশমিক দিয়ে ক্রস-রেফারেন্স করুন, যেমন “(বিষয় ২.১)।”
বিষয়টি spec/structure.md-এ যোগ করুন।
পর্ব পরিচিতি (N.0) তার বিষয়গুলো তালিকাভুক্ত করলে সেখানে একটি বুলেট যোগ করুন।
বিষয়টি en-001, en-gb ও en-us-এ উৎপন্ন করতে python3 tools/localize.py চালান।
just nav চালান, তারপর just test।

বিদ্যমান বিষয় সম্পাদনা

বিভাগের ক্রম ও শিরোনাম অক্ষত রাখুন। পরীক্ষা যাচাই করে যে বিষয়বস্তু বিষয়গুলোতে এখনো প্রতিটি প্রয়োজনীয় বিভাগ আছে।
সম্পাদনা বিশেষভাবে সেগুলো নিয়ে না হলে ইনলাইন সংজ্ঞা, উইকিপিডিয়া লিঙ্ক, টেবিল ও তথ্যসূত্র তালিকা সংরক্ষণ করুন।
এম-ড্যাশ বা নিষিদ্ধ বাক্যাংশ আনবেন না। পুনর্বিন্যাস করলে ড্যাশ ফেলে না দিয়ে বাক্যটি নতুন করে লিখুন।
পরে সম্পাদিত en-gb-oxendict উৎস থেকে en-001, en-gb ও en-us আবার উৎপন্ন করতে python3 tools/localize.py চালান।

পুনঃনামকরণ বা পুনঃক্রমাঙ্কন

locales/en-gb-oxendict/-এ ফাইলটির নাম বদলান, তার # N.M Title শিরোনাম হালনাগাদ করুন, spec/structure.md হালনাগাদ করুন এবং পুরনো নম্বরের দিকে নির্দেশ করা প্রতিটি ক্রস-রেফারেন্স হালনাগাদ করুন।
অন্য তিন লোকেলেও ফাইলের নাম বদলাতে python3 tools/localize.py চালান (এটি একই আপেক্ষিক পথ থেকে চারটিই উৎপন্ন করে)।
just nav ও just test চালান। H1 ও ফাইলের নামে অমিল, নম্বরে ফাঁক, উৎস থেকে সরে যাওয়া লোকেল, বা ভাঙা লিঙ্ক পরীক্ষা চিহ্নিত করবে।

সুরের অনুস্মারক

এমন অভিজ্ঞ সহকর্মীর মতো লিখুন যিনি চান পাঠক সফল হোক। উষ্ণ, সরল, সরাসরি ও কাজের। ছোট বাক্য। কোনো ভরাট কথা নয়।