This is a second attempt at #1450. Rather than start from scratch, I build upon that because I wanted to keep the build changes that @jdesrosiers made.
The idea here is that the proposal document is something that the users will be concerned about, including both a summary of why the proposal is being made and the specific changes to official documents.
There will also a be separate "decision" document (not yet added), which may just be an ADR, that goes through why this solution is being proposed, including pro/con analysis of any alternative designs. We'll continue discussing in #1443 about what this secondary document looks like.
This is a second attempt at #1450. Rather than start from scratch, I build upon that because I wanted to keep the build changes that @jdesrosiers made.
The idea here is that the proposal document is something that the users will be concerned about, including both a summary of why the proposal is being made and the specific changes to official documents.
There will also a be separate "decision" document (not yet added), which may just be an ADR, that goes through why this solution is being proposed, including pro/con analysis of any alternative designs. We'll continue discussing in #1443 about what this secondary document looks like.