From e0fd4ea2b8b59f2d3573893dfebe3833f5f3c227 Mon Sep 17 00:00:00 2001
From: reminec <reminec@noreply.localhost>
Date: Sun, 26 Mar 2023 13:40:43 +0200
Subject: [PATCH] =?UTF-8?q?Premier=20jets=20sur=20les=20d=C3=A9cisions=20R?=
 =?UTF-8?q?enommage=20Modele=20Pas=20de=20gatsby?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-by: grinche

closes #8 @20min, closes #23 @1h40min

_resources/modele-decision.md
---
 .../decisions/_resources/modele-decision.md   | 71 ++++++++++++++++
 .../prendre-et-documenter-des-decisions.md    | 85 +++++++++++++++++++
 2 files changed, 156 insertions(+)
 create mode 100644 data/base-de-connaissances/programmer/patrons/architecture/decisions/_resources/modele-decision.md
 create mode 100644 data/base-de-connaissances/programmer/patrons/architecture/decisions/prendre-et-documenter-des-decisions.md

diff --git a/data/base-de-connaissances/programmer/patrons/architecture/decisions/_resources/modele-decision.md b/data/base-de-connaissances/programmer/patrons/architecture/decisions/_resources/modele-decision.md
new file mode 100644
index 0000000..adc6240
--- /dev/null
+++ b/data/base-de-connaissances/programmer/patrons/architecture/decisions/_resources/modele-decision.md
@@ -0,0 +1,71 @@
+# <UN TITRE ICI>
+
+## Très courte description
+
+<UNE PHRASE ICI>
+
+
+## Courte description
+
+<QUELQUES PHRASES ICI (optionel)>
+
+
+## Description
+
+<QUELQUES PHRASES ICI (optionel)>
+
+
+### Alternatives considérées
+
+* 👀 <ALTERNATIVE 1>
+* 👀 <ALTERNATIVE 2>
+* 👀 <ALTERNATIVE 3>
+
+
+### Élements moteur de la décision
+
+* 🧲 <BESOIN 1>
+* 🧲 <BESOIN 2>
+* 🧲 <BESOIN 3>
+
+
+## Conclusion
+
+* ✅ **<ALTERNATIVE RETENUE 1>**
+* 🤔 **<ALTERNATIVE EVENTUELLE 2 >**
+
+
+### Conséquences
+
+* 👍 <CONSEQUENCE POSITIVE 1>
+* 👍 <CONSEQUENCE POSITIVE 2>
+
+* 👎 <CONSEQUENCE NEGATIVE 1>
+
+
+### Comparaison (Optionel)
+
+#### <ALTERNATIVE 1>
+
+* 👍 <ARGUMENT 1 PRO>
+* 👍 <ARGUMENT 2 PRO>
+* 👎 <ARGUMENT 1 CONTRA>
+
+
+#### <ALTERNATIVE 2>
+
+* 👍 <ARGUMENT 1 PRO>
+* 👍 <ARGUMENT 2 PRO>
+* 👎 <ARGUMENT 1 CONTRA>
+
+
+#### <ALTERNATIVE 3>
+
+* 👍 <ARGUMENT 1 PRO>
+* 👍 <ARGUMENT 2 PRO>
+* 👎 <ARGUMENT 1 CONTRA>
+
+## Aller plus loin
+
+* 🧐 <RESOURCE 1>
+* 🧐 <RESOURCE 2>
\ No newline at end of file
diff --git a/data/base-de-connaissances/programmer/patrons/architecture/decisions/prendre-et-documenter-des-decisions.md b/data/base-de-connaissances/programmer/patrons/architecture/decisions/prendre-et-documenter-des-decisions.md
new file mode 100644
index 0000000..210f724
--- /dev/null
+++ b/data/base-de-connaissances/programmer/patrons/architecture/decisions/prendre-et-documenter-des-decisions.md
@@ -0,0 +1,85 @@
+# Prendre et documenter des décisions
+
+## Très courte description
+
+**Patron de conception** afin de **documenter et justifiés les choix**, par exemple les **choix d'architectures** (**ADR**) dans l'industrie logiciels.
+
+
+## Courte description
+
+Il existe un patron de conception qui s'applique aux décisions architecturales, [ADR](https://adr.github.io/).
+
+Ce patron peut-être **étendu à tout types de décisions**.
+
+
+## Par où commencer ?
+
+Voir le modèle proposé ici [_resources/model-decision.md](./_resources/modele-decision.md)
+
+
+## Description
+
+Les décisions ont besoins d'être **réfléchies** et **documentées**. 
+
+Les resources ci-dessous proposent des guides et exemples d'implémentations.
+
+* [Markdown (ADR)](ADRhttps://adr.github.io/madr/) | _propose des modèles et outils pour maintenir une liste de décisions en Markdown_
+* [Saisie de décision](https://schubmat.github.io/DecisionCapture/) | _encore des modèles_
+
+
+#### Définition
+##### **Architectural decision (AD)** _Décision architecturale_
+
+**Choix justifié qui répond à une exigence** fonctionnelle ou non fonctionnelle **significative** sur le plan architectural.
+
+Les **décisions d'architecture** répondent à des **exigences importantes** ; elles sont perçues comme **difficiles à prendre** et/ou **coûteuses à modifier**.
+
+
+##### Architecturally Significant Requirement (ASR)
+
+Les **exigences architecturallement significatives** sont celles qui ont un effet **mesurable** sur l'architecture. 
+
+Il s'agit d'**un sous-ensemble d'exigences**, le sous-ensemble qui affecte l'architecture d'un système de **manière mesurable** et **identifiable**.
+
+
+## En savoir plus
+
+* **ADR**: https://adr.github.io/
+* **Saisie de Décision**: https://schubmat.github.io/DecisionCapture/
+
+
+### Voir aussi
+
+##### Exemples
+* https://forge.liiib.re/libre.sh/libre.sh/-/tree/develop/docs
+
+
+## License
+
+[CC BY-SA 2.0 FR](https://creativecommons.org/licenses/by-sa/2.0/fr/)
+
+### Autheurices
+* grincheuxx
+* reminec @ acides.org (Tedomum.net)
+
+_Librement traduit depuis adr.github.io_
+
+## Versions
+### v0.1.0
+_Date : 26 mars 2023 | Temps rédaction : 25min_ | reminec
+* Reformatage 
+* Editions
+* Ne concerne plus que les ADR mais toutes les décisions
+
+### v0.0.2
+_Date : 17 mars 2023 | Temps rédaction : 30min_ | reminec
+* Reformatage
+* Editions
+
+### v0.0.1
+_Date : 17 mars 2023 | Temps rédaction : 30min_ | reminec, grincheuxx
+* Introduction à l'ADR par 2 novices sans experts
+
+## Remerciements
+
+* [PierreO.](https://mastodon.indie.host/@pierreozoux) @ [indiehosters.net](https://indiehosters.net) - Pour avoir soufflé ce patron de conception
\ No newline at end of file