تصنیف: موضوعات لکھنا اور ترمیم کرنا

لکھنے سے پہلے

اسلوب کے اصول اور ریپوزٹری کی جڑ میں spec/conventions.md پڑھیں۔
ریپوزٹری کی جڑ میں spec/structure.md دیکھیں تاکہ معلوم ہو موضوع کہاں فٹ ہوتا ہے اور اس کا نمبر کیا ہونا چاہیے۔

نیا موضوع لکھنا

حصہ اور اس حصے میں اگلا خالی اعشاری نمبر چنیں۔ نمبرنگ مسلسل ہے، اس لیے نیا موضوع عموماً اپنے حصے کے آخری موضوع کے بعد کا نمبر لیتا ہے۔
موضوع کے ٹیمپلیٹ سے locales/en-gb-oxendict/topics/PP-CC-slug.md بنائیں (صفر سے بھرا اور ہائفن سے الگ سابقہ، مثلاً 02-01-...)۔ آکسفورڈ ہجے میں لکھیں (دیکھیں spec/oxford-spelling.md)؛ باقی تین لوکیلز کو کبھی براہِ راست ایڈٹ نہ کریں۔
ٹیمپلیٹ کے مطابق لکھیں۔ مواد کے موضوع کو تمام حصے چاہییں: جائزہ، کلیدی اصول، سفارشات، سمجھوتے (جدول کے ساتھ)، بحث کے سوالات، شعبہ جاتی نظر (اسٹارٹ اپ، چھوٹا کاروبار، بڑا ادارہ، حکومت)، مثالیں (ایک کاروباری اور ایک سرکاری)، کاروباری مقدمہ، مخالف نمونے، پانچ درجوں کا پختگی کا نمونہ، بحث کے خیالات، اہم نکات، اور حوالہ جات۔
ہیرا پھیری کی راہ کا نام لیں۔ ہر میٹرکس کے خاندان کو اس کا صریح جواب چاہیے کہ “ٹیم اس عدد کو اس چیز کو بہتر کیے بغیر اچھا کیسے دکھاتی ہے جسے وہ ناپتا ہے، اور کون سی حفاظتی حد اسے پکڑتی ہے” (دیکھیں موضوع 1.2)۔
اصطلاحات کی پہلی بار استعمال پر تعریف کریں۔ کلیدی تصورات کے لیے پہلی بار ذکر پر وکیپیڈیا کا لنک شامل کریں، صرف نثر میں۔
متعلقہ موضوعات کا ان کے اعشاری نمبر سے باہمی حوالہ دیں، مثلاً “(موضوع 2.1)“۔
موضوع کو 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 اور فائل کے نام کے عدم مطابقت، نمبرنگ کے خلا، ماخذ سے بھٹکے ہوئے لوکیل، یا ٹوٹے ہوئے لنک کی نشاندہی کریں گے۔

لہجے کی یاد دہانی

ایک تجربہ کار ساتھی کی طرح لکھیں جو چاہتا ہے کہ قاری کامیاب ہو۔ گرمجوش، سادہ، براہِ راست، اور مفید۔ مختصر جملے۔ بھرتی نہیں۔