RFC سے ADR تک: فیصلہ تک پہنچنا اور استدلال کو برقرار رکھنا

وہ فیصلہ جسے کوئی بھی دوبارہ نہیں بنا سکا۔

نئے ٹیک لیڈ نے ایک معقول سوال پوچھا: ہر سروس اس قطار کے ذریعے بلنگ سسٹم سے کیوں بات کرتی ہے؟ ایک ADR ہے — ADR-014، چار جملے، گیارہ ماہ پہلے لکھا گیا۔ سیاق و سباق: "ہمیں قابل اعتماد بلنگ انٹیگریشن کی ضرورت تھی۔" فیصلہ: "قطار کا استعمال کریں۔" نتائج: "کچھ اضافی تاخیر۔" یہ تکنیکی طور پر ایک ریکارڈ ہے۔ یہ کچھ بھی جواب نہیں دیتا۔

آپ وہاں تھے، اس لیے آپ جانتے ہیں کہ ADR-014 کیا نہیں کہتا: دو سلیک چینلز میں تین ہفتوں کا بحث اور ایک گرم PR تھریڈ؛ ہم وقتی API کا آپشن جو ایک ریٹ کی حد کی وجہ سے ہار گیا جو بعد میں بڑھا دی گئی؛ عملے کے انجینئر کا اعتراض جس کا جواب ایک بینچ مارک سے دیا گیا جسے اب کوئی نہیں ڈھونڈ سکتا۔ بحث ہوئی۔ ریکارڈ بعد میں، یادداشت سے، ایک شخص نے، ایک جمعہ کو لکھا۔

یہ ایک دستاویزی، تقریباً عالمی ناکامی کا طریقہ ہے جو واقعی ایک اچھی مشق ہے۔ AWS کی تجویز کردہ رہنمائی اور مائیکروسافٹ کے ویل آرکیٹیکٹڈ دستاویزات دونوں ADRs کی سفارش کرتے ہیں — اور دونوں درد کا ذکر کرتے ہیں: انہیں موجودہ رکھنا وقت لیتا ہے، اور ان کا انتظام کرنا پیچیدہ ہو جاتا ہے جب ٹیمیں اور انتخاب بڑھتے ہیں۔ بنیادی وجہ ساختی ہے: بحث اور ریکارڈ مختلف جگہوں پر موجود ہیں، اس لیے ریکارڈ ہمیشہ ایک نقصان دہ نقل ہوتا ہے۔ حل یہ ہے کہ انہیں ایک ہی جگہ بنایا جائے۔ نہ ہی یہ مشق انجینئرنگ کے مخصوص ہے، اور نہ ہی ADR کے مخصوص۔ گوگل ایک ڈیزائن دستاویز کی ضرورت رکھتا ہے — مسئلہ، تجویز کردہ طریقہ، متبادل پر غور، تجارتی نقصانات — جو اہم تکنیکی کام شروع ہونے سے پہلے لکھی اور جائزہ لی جاتی ہے، یہ ایک مشق ہے جو کمپنی کی اپنی سافٹ ویئر انجینئرنگ ایٹ گوگل میں بیان کی گئی ہے۔ یہ ADR کی طرح ہی ایک نظم ہے، جو ایک قدم پہلے لاگو کی گئی ہے: ADR اس انتخاب کو ریکارڈ کرتا ہے جس پر ڈیزائن دستاویز نے بحث کی۔ دونوں ایک ہی وجہ سے ایک ہی طرح ناکام ہوتے ہیں، اور دونوں کو ایک ہی اقدام سے درست کیا جاتا ہے — بحث کو اس جگہ رکھیں جہاں ریکارڈ موجود ہے، بجائے اس کے کہ ایک کو دوسرے میں بعد میں نقل کریں۔ نیچے ہر قدم کو دونوں آرٹيفیکٹس کا احاطہ کرنے کے طور پر پڑھیں۔

ADRs کیوں سڑتے ہیں

ADR کمیونٹی کے اپنے مواد میں سے ایک جملہ پوری تشخیص کو بیان کرتا ہے: ایک RFC عام طور پر اتفاق رائے تک پہنچنے کے بارے میں ہوتا ہے؛ ایک ADR اس اتفاق رائے کو ریکارڈ کرتا ہے جب یہ حاصل ہو جائے۔ دو آرٹيفیکٹس، دو لمحے — اور ان کے درمیان سب کچھ لیک ہو جاتا ہے۔ جو متبادل "ظاہر" طور پر غلط تھے وہ ریکارڈ نہیں ہوتے (جب تک کہ وہ ظاہر ہونا بند نہ کر دیں)۔ اعتراض جو حتمی ڈیزائن کو شکل دیتا ہے صرف ایک بند تھریڈ پر PR تبصرے کے طور پر زندہ رہتا ہے۔ سیاق و سباق کا سیکشن آخری، بدترین، ان لوگوں کے ذریعہ لکھا جاتا ہے جو نہ ہونے کے کھیل میں ہار گئے۔ میٹنگز جو فیصلے پیدا کرنی چاہئیں تھیں، خلاصے پیدا کرتی ہیں، اور وہ استدلال جو فیصلے کو پائیدار بناتا ہے — وہ چیز جس پر پوری فیصلے کے معیار کی زنجیر منحصر ہے — بالکل وہی ہے جو نقل میں چھوڑ دیا جاتا ہے۔

مرحلہ 1–3: تجویز، سیاق و سباق، اختیارات

1. 1پیشکش کو بنیادی دعویٰ کے طور پر بیان کریں — تجویز کردہ فیصلہ، سوال نہیں: "ہم تمام بلنگ کی تحریروں کو ایک مستقل قطار کے ذریعے منتقل کریں گے۔" یہ جملہ مستقبل کے ADR کا عنوان ہے۔ چیک پوائنٹ: بنیادی موجود ہے، ایک جملہ، پیش کرنے والے کی طرف سے لکھا گیا۔
2. 2سیاق بطور علیحدہ دلائل۔ ہر قوت جو فیصلے کو ضروری بناتی ہے — قابل اعتماد ہونے کی ضرورت، بلنگ سسٹم کی شرح کی حد، آڈٹ کا حکم — اپنی جڑ کے تحت اپنا الگ دلیل ہے۔ ایک یکساں "سیاق" پیراگراف کو چیلنج نہیں کیا جا سکتا؛ تین علیحدہ سیاق کے دعوے ہر ایک کو انفرادی طور پر سوال کیا جا سکتا ہے، تصدیق کی جا سکتی ہے، یا مسترد کیا جا سکتا ہے۔ چیک پوائنٹ: ≥2 سیاق کے دلائل، ہر ایک قوت۔
3. 3ہر آپشن کا اپنا نوڈ ہوتا ہے۔ قطار، ہم وقتی API، بیچ کام — بہن بھائی کے دلائل، ہر ایک کے اپنے فوائد اور نقصانات ہیں۔ فائدہ/نقصان والدین کے لحاظ سے ہوتا ہے، لہذا کسی آپشن کے نقصانات اسی آپشن سے جڑے ہوتے ہیں، فیصلے سے نہیں۔ ان آپشنز کو شامل کریں جن کی آپ توقع کرتے ہیں کہ آپ مسترد کریں گے: مسترد شدہ بہن بھائی وہ ہے جو اگلے سال کے "ہم نے صرف کیوں نہیں..." کا جواب دیتا ہے۔ چیک پوائنٹ: ہر آپشن جس کے بارے میں ایک قاری پوچھ سکتا ہے موجود ہے۔

مرحلہ 4–6: آر ایف سی کا دور جو ایک ریکارڈ چھوڑتا ہے

اب جائزہ کا دور — عام طور پر یہ حصہ گفتگو، تبصروں اور ہالوں میں پھیلا ہوتا ہے۔ یہاں یہ تین قسم کے منظم تبادلے کے طور پر چلتا ہے، ہر ایک ایک چار موڑ کی گفتگو ہے جو ایک جائزہ لینے والے اور آپشن کے مصنف کے درمیان ہوتی ہے:

مرحلہ 7: فیصلہ کرنا — اور درجہ بندی کیا نہیں ہے

فیصلہ ساز اختیارات کی درجہ بندی کرتے ہیں: ہر ایک کو ایک لیبل لگا ہوا درجہ بندی۔ تقسیم حقیقی ثبوت ہے — جہاں کمرہ کھڑا تھا، ریکارڈ پر، کال سے پہلے۔ لیکن درجہ بندی فیصلہ نہیں ہے۔ ایک نامزد انسان ابھی بھی فیصلہ کرتا ہے، اور اگر کال تقسیم کے خلاف جاتی ہے، تو فیصلہ کا نقطہ وہیں ہے جہاں اس کی وضاحت کی جاتی ہے۔ (وہ نامزد انسان کون ہونا چاہیے، اور بحث سے پہلے اس کردار کو کیسے تفویض کیا جائے بجائے اس کے کہ بعد میں، یہ اپنی ایک ڈسپلن ہے — دیکھیں فیصلہ حقوق کا سبق.)

مرحلہ 8–9: ADR جو آپ کو لکھنے کی ضرورت نہیں تھی

یہاں ادائیگی ہے۔ ریکارڈ ایک ایسا دستاویز نہیں ہے جو آپ بعد میں لکھتے ہیں — یہ منتخب کردہ آپشن کا نوڈ ہے اور اس کے ساتھ پہلے سے منسلک سب کچھ: سیاق و سباق کے دلائل (Context)، مسترد کردہ بہنیں (Options Considered)، مکمل شدہ زنجیریں (بحث، مصنفین کے ساتھ)، درجہ بندیاں (جہاں کمرہ کھڑا تھا)، اور فیصلہ کا دلیل اس کی وضاحت کے ساتھ (Decision)۔ کچھ بھی نقل نہیں کیا جاتا، لہذا نقل میں کچھ بھی کھویا نہیں جاتا۔

1. 1ان نتائج کو ریکارڈ کریں جنے آپ قبول کر رہے ہیں۔ معلوم نقصانات — اضافی تاخیر، قطار کا عملی بوجھ — منتخب کردہ آپشن کے کن-بچوں کے طور پر جاری رہتے ہیں، جنہیں فیصلہ کرنے والے نے تسلیم کیا ہے۔ انہیں لکھنا اس کو ایک فیصلہ بناتا ہے نہ کہ ایک پسند۔ چیک پوائنٹ: ≥1 قبول شدہ نتیجہ ریکارڈ پر۔
2. 2برآمد کریں اگر آپ کی تنظیم کو ریپو سے ٹریڈ ADRs کی ضرورت ہو۔ بہت سی تنظیمیں کرتی ہیں، صحیح طور پر — کوڈ کے ساتھ موجود مارک ڈاؤن ADR تعمیل کا آرٹفیکٹ رہتا ہے۔ درخت سے چار حصوں کا خلاصہ لکھیں (پانچ منٹ، جمعہ نہیں)، مکمل بحث کے لیے گفتگو کی طرف واپس لنک کریں۔ چیک پوائنٹ: ریپو ADR درخت کا حوالہ دیتا ہے؛ درخت میں استدلال موجود ہے۔

اختلاف کریں اور عزم کریں، ریکارڈ پر

ایمیزون نے جو طرز مشہور کیا — اختلاف کریں اور پابند رہیں — اس میں ایک پڑھنے کی مشکل ہے: بعد میں کوئی کیسے جان سکتا ہے کہ اختلاف حقیقی، سنا گیا، اور جواب دیا گیا تھا، نہ کہ دبایا گیا؟ زنجیر کے میکانکس اس کا جواب دیتے ہیں۔ ایک جائزہ زنجیر جو اپنے مکمل چار مراحل سے گزری اور بغیر اتفاق کے مکمل ہوئی، بالکل رسید ہے: اعتراض کیا گیا، جواب دیا گیا، دباؤ ڈالا گیا، اور دوبارہ جواب دیا گیا، ریکارڈ پر، اس سے پہلے کہ اختلاف کرنے والا پابند ہو۔ اختلاف کرنے والے کا یہ دستاویزی ثبوت ہے کہ اسے سنا گیا — جو بعد میں پابند ہونے کو معقول بناتا ہے نہ کہ صرف اطاعت۔

مرحلہ 10: حذف کیے بغیر متبادل کرنا

فیصلے کی عمر۔ جب وہ شرح حد جو ہم وقتی اختیار کو ختم کرتی ہے بڑھائی جاتی ہے، تو صحیح اقدام ایک نیا فیصلہ ہے جو اس کا حوالہ دیتا ہے جسے یہ تبدیل کرتا ہے — ایک نیا دلیل جو ADR-014 کے نوڈ سے منسلک ہے، جو بتاتا ہے کہ کیا تبدیل ہوا۔ پرانا فیصلہ پڑھنے کے قابل رہتا ہے؛ اس کی وجہ بالکل وہی ہے جس کی وجہ سے نیا فیصلہ جانتا ہے کہ وہ کیا ختم کر رہا ہے۔

ایک ایماندار خلا جس کا واضح طور پر انتظام کرنا ہے: کوئی بلٹ ان ADR حیثیت کا میدان نہیں ہے۔ مجوزہ / قبول شدہ / منسوخ کسی دلیل پر پہلی درجہ کی حالت نہیں ہے — منسوخی کو لنکنگ کے ذریعے ماڈل کیا گیا ہے، اور یہ روایت آپ کی ہے کہ آپ اسے برقرار رکھیں۔ اسے اپنی ٹیم کے کام کے معاہدے میں بیان کریں بجائے اس کے کہ یہ فرض کر لیں کہ پروڈکٹ اسے نافذ کرتی ہے۔

ایماندار حدود

• ✗یہ آپ کے ریپوزٹری میں ADRs کی جگہ نہیں لیتا اگر آپ کی تنظیم کو انہیں کوڈ کے ساتھ ورژن کنٹرول میں رکھنے کی ضرورت ہے۔ خلاصہ برآمد کریں اور کمیٹ کریں؛ اس حصے کے لیے درخت کا استعمال کریں جہاں مارک ڈاؤن خراب ہے — بحث۔
• ✗کوئی ADR حیثیت کا میدان نہیں۔ تجویز کردہ/قبول شدہ/مکمل شدہ ایک لنکنگ کنونشن ہے جسے آپ برقرار رکھتے ہیں، یہ کوئی چیز نہیں ہے جو پروڈکٹ نافذ کرتی ہے۔
• ✗ایک زنجیر چار موڑ ہے۔ گہرے تعمیراتی اختلاف کے لیے ایک کال کی ضرورت ہوگی؛ زنجیر اس بات کا ریکارڈ ہے کہ پہلے کیا کوشش کی گئی تھی۔
• ✗ریٹنگز ایک واحد لیبل شدہ قیمت ہیں، نہ کہ وزنی کثیر المعیاری اسکورنگ۔
• ✗یہ کسی کو بھی اچھا سیاق لکھنے پر مجبور نہیں کرتا۔ ساخت ایک اچھے ریکارڈ کی قیمت کو کم کرتی ہے؛ یہ فیصلہ فراہم نہیں کرتی۔

عملی اسباق

• ✓ایک RFC، ایک بحث۔ پورے سہ ماہی کی تعمیرات کو ڈھانپنے والے میگا درخت کا مقابلہ کریں — سپرسیشن لنکس فیصلوں کو نیسٹنگ سے بہتر طریقے سے جوڑتے ہیں۔
• ✓جو موجود ہے اس سے بیج نکالو۔ ایک فیصلہ کن ٹرانسکرپٹ یا آپ کا پرانا ADR فولڈر، نکالا گیا، بحث کو ایک تیز آغاز دیتا ہے — درآمد شدہ کے طور پر لیبل لگا ہوا، تاکہ زندہ دلائل کو ممتاز رکھا جا سکے۔
• ✓جائزہ لینے والوں کے نام ان کی زنجیروں پر لکھ دیں اور انہیں وہاں چھوڑ دیں۔ نسبت ہی جوابدہی ہے؛ نامعلوم تعمیراتی اعتراضات کہانیوں میں تبدیل ہو جاتے ہیں۔
• ✓نتائج کا سیکشن فیصلہ کرنے والے کا ہے، کسی اور کا نہیں۔ جن نقصانات کو قبول کرنے والے شخص نے لکھا ہے، ان کا وزن ایک جائزہ لینے والے کی تنبیہوں سے مختلف ہوتا ہے۔

ADR-014، وہ ورژن جو جواب دیتا ہے

نئے ٹیک لیڈ کے سوال کی طرف واپس آتے ہیں۔ دوبارہ تعمیر شدہ ورژن میں، ADR-014 ایک نوڈ ہے: قطار کا فیصلہ اس کی وضاحت کے ساتھ، تین سیاق و سباق کی قوتیں (ایک اب بیکار — واضح طور پر)، ایک مسترد شدہ ہم وقتی-API بہن جس کا مہلک نام پرانا ریٹ لمٹ ہے، چار مکمل شدہ جائزہ زنجیریں جن میں عملے کے انجینئر کی بھی شامل ہے، اور بینچ مارک بطور ثبوت منسلک ہے۔ ٹیک لیڈ دس منٹ تک پڑھتا ہے، ریٹ لمٹ میں تبدیلی دیکھتا ہے، اور پرانے نوڈ سے منسلک ایک متبادل تجویز کھولتا ہے۔ کوئی بھی سلیک کو کھودتا نہیں ہے۔ یہ پوری وعدہ ہے: زنجیریں معاہدے تک پہنچتی ہیں، درخت اسے ریکارڈ کرتا ہے — اور ریکارڈ ان سوالات کے جوابات دیتا ہے جن کے بارے میں آپ کو نہیں معلوم تھا کہ یہ پوچھے جائیں گے۔