Architecture Decision Recordअच्छे ADR लिखने के सुझाव
एक अच्छे ADR की विशेषताएँ:
तर्क (Rationale): किसी विशेष AD को करने के कारण समझाएँ। इसमें संदर्भ (नीचे देखें), विभिन्न संभावित विकल्पों के लाभ और हानियाँ, सुविधाओं की तुलना, लागत/लाभ की चर्चा, और बहुत कुछ शामिल हो सकता है।
विशिष्ट (Specific): प्रत्येक ADR एक ही AD के बारे में होना चाहिए, अनेक AD के बारे में नहीं।
टाइमस्टैम्प (Timestamps): बताएँ कि ADR का प्रत्येक अंश कब लिखा गया। यह उन पहलुओं के लिए विशेष रूप से महत्वपूर्ण है जो समय के साथ बदल सकते हैं, जैसे लागत, समय-सारणी, स्केलिंग आदि।
अपरिवर्तनीय (Immutable): ADR में मौजूद जानकारी को न बदलें। इसके बजाय, नई जानकारी जोड़कर ADR में संशोधन करें, या नया ADR बनाकर पुराने ADR को प्रतिस्थापित करें।
ADR के एक अच्छे "संदर्भ" (Context) खंड की विशेषताएँ:
अपने संगठन की स्थिति और व्यावसायिक प्राथमिकताएँ समझाएँ।
अपनी टीमों की सामाजिक और कौशल संरचना पर आधारित तर्क और विचार शामिल करें।
प्रासंगिक लाभ और हानियाँ शामिल करें, और उन्हें ऐसे शब्दों में बताएँ जो आपकी आवश्यकताओं और लक्ष्यों से मेल खाते हों।
ADR के एक अच्छे "परिणाम" (Consequences) खंड की विशेषताएँ:
समझाएँ कि निर्णय लेने से क्या-क्या होगा। इसमें प्रभाव, नतीजे, उत्पाद, आगे की कार्रवाई और बहुत कुछ शामिल हो सकता है।
किसी भी आगामी ADR की जानकारी शामिल करें। एक ADR के कारण और ADR की आवश्यकता पड़ना आम बात है, जैसे जब एक ADR कोई बड़ा व्यापक चयन करता है, जिससे आगे अनेक छोटे निर्णयों की आवश्यकता बनती है।
कार्रवाई के बाद की किसी भी समीक्षा प्रक्रिया को शामिल करें। टीमों के लिए प्रत्येक ADR की एक माह बाद समीक्षा करना आम बात है, ताकि ADR की जानकारी की तुलना वास्तविक व्यवहार में जो हुआ उससे की जा सके, और सीखा तथा आगे बढ़ा जा सके।
नया ADR पिछले ADR का स्थान ले सकता है:
- जब कोई AD किसी पिछले ADR को प्रतिस्थापित या अमान्य करता है, तब एक नया ADR बनाया जाना चाहिए