Architecture Decision Recordভালো ADR লেখার পরামর্শ
একটি ভালো ADR-এর বৈশিষ্ট্য:
যুক্তি: নির্দিষ্ট AD নেওয়ার কারণ ব্যাখ্যা করুন। এর মধ্যে থাকতে পারে প্রেক্ষাপট (নিচে দেখুন), বিভিন্ন সম্ভাব্য পছন্দের সুবিধা-অসুবিধা, বৈশিষ্ট্যের তুলনা, খরচ/উপকারের আলোচনা ও আরও অনেক কিছু।
সুনির্দিষ্ট: প্রতিটি ADR একটি AD নিয়ে হওয়া উচিত, একাধিক AD নিয়ে নয়।
টাইমস্ট্যাম্প: ADR-এর প্রতিটি অংশ কখন লেখা হয়েছে তা চিহ্নিত করুন। খরচ, সময়সূচি, সম্প্রসারণ ইত্যাদির মতো যেসব দিক সময়ের সঙ্গে বদলাতে পারে, সেগুলোর জন্য এটি বিশেষভাবে গুরুত্বপূর্ণ।
অপরিবর্তনীয়: ADR-এর বিদ্যমান তথ্য বদলাবেন না। বরং নতুন তথ্য যোগ করে ADR সংশোধন করুন, অথবা নতুন ADR তৈরি করে সেটিকে প্রতিস্থাপন করুন।
ADR-এর একটি ভালো “প্রেক্ষাপট” অংশের বৈশিষ্ট্য:
আপনার সংগঠনের পরিস্থিতি ও ব্যবসায়িক অগ্রাধিকার ব্যাখ্যা করুন।
আপনার দলগুলোর সামাজিক ও দক্ষতাগত গঠনের ভিত্তিতে যুক্তি ও বিবেচনা অন্তর্ভুক্ত করুন।
প্রাসঙ্গিক সুবিধা-অসুবিধা অন্তর্ভুক্ত করুন এবং সেগুলো আপনার প্রয়োজন ও লক্ষ্যের সঙ্গে সামঞ্জস্যপূর্ণ ভাষায় বর্ণনা করুন।
ADR-এর একটি ভালো “পরিণতি” অংশের বৈশিষ্ট্য:
সিদ্ধান্ত নেওয়ার ফলে কী ঘটে তা ব্যাখ্যা করুন। এর মধ্যে থাকতে পারে প্রভাব, ফলাফল, আউটপুট, পরবর্তী পদক্ষেপ ও আরও অনেক কিছু।
পরবর্তী যেকোনো ADR সম্পর্কে তথ্য অন্তর্ভুক্ত করুন। একটি ADR আরও ADR-এর প্রয়োজন তৈরি করা তুলনামূলকভাবে প্রচলিত, যেমন যখন একটি ADR বড় ও সামগ্রিক পছন্দ নেয়, যা পরে আরও ছোট সিদ্ধান্তের প্রয়োজন তৈরি করে।
কাজ-পরবর্তী যেকোনো পর্যালোচনা প্রক্রিয়া অন্তর্ভুক্ত করুন। দলগুলো সাধারণত এক মাস পর প্রতিটি ADR পর্যালোচনা করে, যাতে ADR-এর তথ্য বাস্তব অনুশীলনে যা ঘটেছে তার সঙ্গে তুলনা করে শেখা ও এগিয়ে যাওয়া যায়।
নতুন ADR আগের ADR-এর স্থান নিতে পারে:
- যখন এমন একটি AD নেওয়া হয় যা আগের ADR-কে প্রতিস্থাপন বা অকার্যকর করে, তখন একটি নতুন ADR তৈরি করা উচিত