Comments (2)
This can also be addressed by changing the template like:
<!-- This is an optional element. Feel free to remove. -->
-### Positive Consequences
-
-* {e.g., improvement of one or more desired qualities, …}
-* …
-
-<!-- This is an optional element. Feel free to remove. -->
-### Negative Consequences
+### Consequences
-* {e.g., compromising one or more desired qualities, …}
+* Good, because {e.g., one or more desired qualities, …}
+* Neutral, because {e.g., one or more desired qualities, …}
* …
from madr.
Let's have a try for a longer list of "Options".
Markdown
<!-- This is an optional element. Feel free to remove. -->
## Pros and Cons of the Options
### {title of option 1}
<!-- This is an optional element. Feel free to remove. -->
{example | description | pointer to more information | …}
#### Pros
* {argument a}
* {argument b}
#### Neutral
* {argument c}
#### Cons
* {argument d}
Example
(based on https://github.com/adr/madr/blob/main/docs/decisions/0015-include-consulting-informed-of-raci.md)
Pros and Cons of the Options
Include "Consulted" and "Informed" of RACI
Pros
- These two roles of RACI are well understood.
- We make these fields optional, thus it keeps MADR still lightweight.
Cons
- It adds two additional fields
Include all fields of RACI
This would add "Responsible", "Accountable", "Consulted", and "Informed"
Pros
- Complete RACI would be included
Cons
- Get confused about who is "accountable" and who is "responsible".
- If decisions are mostly taken by consensus in small committees, then there might not be an "accountable" person.
Thoughts
I think, this is really lengthy. Not sure if MADR can still be called "lightweight" then.
Maybe, it is a tooling issue?
- In case MADR stays as is, a tool could allow with drag'n'drop to put arguments of options to consequences and reformat them accordingly
- In case MADR is modified, a tool could render MADR in a "leightweight" form
Other options
Using "Positive, because" and "Negative, because"
- Bad, because this does not list real consequences, but is just a synonym for "good" and "bad"
Remove "Positive Consequences" and "Negative Consequences"
They don't seem to be used much in the wild, thus why not just removing them and leaving it open to everyone?
from madr.
Related Issues (20)
- Replace "Deciders" by "Decision Maker(s)"
- Peer repo has a copy of an outdated MADR template
- Link to latest releases in each major version from the homepage HOT 1
- Use GitHub template feature to speed up usage HOT 3
- 404 - https://adr.github.io/madr/ HOT 3
- Discuss "Good, because" vs. "Pros:" HOT 7
- More general text at the template
- Do we need "consulted" and "informed"? HOT 1
- Question: v2 vs. v3 HOT 3
- Add links to tools supporting MADR HOT 1
- Something is wrong with the wording in the template
- Comment on compatibility with IEEE 42010
- Provide "naked" template?
- Most examples are still on template Version 2 (or older) HOT 1
- Hyperlink in status metadata causes YAML parser to report error HOT 7
- Add branches to latest major versions HOT 2
- Decision Drivers / Forces HOT 5
- Think of switchting to other theme
- Can ADRs replace design docs and RFCs? HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from madr.