Κατευθυντήριες γραμμές για βιώσιμες αποφάσεις

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Μάθαμε τα παρακάτω διδάγματα στη δουλειά μας, τα οποία μπορούν να χρησιμεύσουν ως κατευθυντήριες γραμμές και αξιολόγηση για την επίτευξη βιώσιμων αποφάσεων:

Χρησιμοποιήστε μια λιτή/μινιμαλιστική προσέγγιση για την αρχική τεκμηρίωση των αποφάσεων.
Ιεραρχήστε και καταγράψτε όλες τις σημαντικές αποφάσεις που είναι αρκετά σχετικές ώστε να τεκμηριωθούν και να γίνει κατανοητή η αρχιτεκτονική-στόχος.
Αναπτύξτε λεπτομερώς τις ιδιαίτερα σημαντικές αποφάσεις με πλήρη πρότυπα μόνο αφού ολοκληρωθεί η αρχική εργασία (δηλαδή όταν οι υπεύθυνοι λήψης αποφάσεων είναι ικανοποιημένοι με τις αρχιτεκτονικές αποφάσεις που ελήφθησαν και βέβαιοι ότι αυτές δεν χρειάζεται να αναθεωρηθούν σύντομα).
Χρησιμοποιήστε τις λιτές/μινιμαλιστικές εκδόσεις από το βήμα 1 ως σύντομη έκδοση των τεκμηριωμένων αποφάσεων με το κατάλληλο επίπεδο λεπτομέρειας, ώστε να παρέχουν μια επισκόπηση των αναλυτικών αποφάσεων, καθώς και για τις ασήμαντες ή προφανείς αποφάσεις.
Όπου είναι δυνατόν, χρησιμοποιήστε την υπάρχουσα αρχιτεκτονική γνώση, είτε από μοντέλα καθοδήγησης είτε από άλλες πηγές. Εξετάστε και επεκτείνετε αυτή τη γνώση και προσαρμόστε την στο πλαίσιο της συγκεκριμένης απόφασης.
Βεβαιωθείτε ότι έχουν καθιερωθεί σύνδεσμοι ιχνηλασιμότητας μεταξύ αποφάσεων και τόσο απαιτήσεων όσο και αρχιτεκτονικών σχεδιάσεων/κώδικα.
Παρέχετε αυτοματοποιημένο έλεγχο συνέπειας ώστε να διασφαλίζεται ότι οι σύνδεσμοι ιχνηλασιμότητας παραμένουν συγχρονισμένοι μετά από μια αλλαγή. Περιορίστε τον αριθμό των εξαρτήσεων μεταξύ αποφάσεων και άλλων τεχνουργημάτων λογισμικού.
Εφαρμόστε τις κατευθυντήριες γραμμές για τις αιτιολογήσεις με συνέπεια και αποφασιστικότητα — είναι το σημαντικότερο μέρος της τεκμηρίωσης των αποφάσεων επειδή δίνουν το σκεπτικό.