Architecture Decision Record

Active theme: Light

← έγγραφα

Προτάσεις για τη συγγραφή καλών ADR

Χαρακτηριστικά ενός καλού ADR:

  • Αιτιολόγηση: Εξηγήστε τους λόγους για τους οποίους λαμβάνεται η συγκεκριμένη αρχιτεκτονική απόφαση. Αυτό μπορεί να περιλαμβάνει το πλαίσιο (βλ. παρακάτω), τα υπέρ και τα κατά των διαφόρων πιθανών επιλογών, συγκρίσεις χαρακτηριστικών, συζητήσεις κόστους/οφέλους και άλλα.

  • Συγκεκριμένο: Κάθε ADR πρέπει να αφορά μία αρχιτεκτονική απόφαση, όχι πολλές.

  • Χρονοσημάνσεις: Προσδιορίστε πότε γράφτηκε κάθε στοιχείο του ADR. Αυτό είναι ιδιαίτερα σημαντικό για πτυχές που μπορεί να αλλάξουν με την πάροδο του χρόνου, όπως το κόστος, τα χρονοδιαγράμματα, η κλιμάκωση και τα παρόμοια.

  • Αμετάβλητο: Μην αλλάζετε τις υπάρχουσες πληροφορίες σε ένα ADR. Αντίθετα, τροποποιήστε το ADR προσθέτοντας νέες πληροφορίες ή αντικαταστήστε το δημιουργώντας ένα νέο ADR.

Χαρακτηριστικά μιας καλής ενότητας «Πλαίσιο» σε ένα ADR:

  • Εξηγήστε την κατάσταση του οργανισμού σας και τις επιχειρηματικές προτεραιότητες.

  • Συμπεριλάβετε αιτιολόγηση και σκέψεις βάσει της κοινωνικής σύνθεσης και των δεξιοτήτων των ομάδων σας.

  • Συμπεριλάβετε τα σχετικά υπέρ και κατά και περιγράψτε τα με όρους που ευθυγραμμίζονται με τις ανάγκες και τους στόχους σας.

Χαρακτηριστικά μιας καλής ενότητας «Συνέπειες» σε ένα ADR:

  • Εξηγήστε τι προκύπτει από τη λήψη της απόφασης. Αυτό μπορεί να περιλαμβάνει τις επιπτώσεις, τα αποτελέσματα, τα παραγόμενα, τις ενέργειες παρακολούθησης και άλλα.

  • Συμπεριλάβετε πληροφορίες για τυχόν επόμενα ADR. Είναι σχετικά συνηθισμένο ένα ADR να προκαλεί την ανάγκη για περισσότερα ADR, για παράδειγμα όταν ένα ADR κάνει μια μεγάλη υπερκαλύπτουσα επιλογή, η οποία με τη σειρά της δημιουργεί ανάγκες για περισσότερες μικρότερες αποφάσεις.

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

Ένα νέο ADR μπορεί να αντικαταστήσει ένα προηγούμενο ADR:

  • Όταν λαμβάνεται μια αρχιτεκτονική απόφαση που αντικαθιστά ή ακυρώνει ένα προηγούμενο ADR, πρέπει να δημιουργηθεί ένα νέο ADR