Changes
Page history
propose adr-100 and adr-101
authored
Nov 18, 2025
by
anarcat
Show whitespace changes
Inline
Side-by-side
service/documentation.md
View page @
0716ae42
...
@@ -340,10 +340,16 @@ exhaustive procedure might look something like this:
...
@@ -340,10 +340,16 @@ exhaustive procedure might look something like this:
make sure you have a good title that summarizes everything in a
make sure you have a good title that summarizes everything in a
single line
single line
6.
**send document for approval**
: this will vary wildly depending on
6.
**send document for approval**
: bring up the proposal in a meeting
the affected users, but now you should send your document and hope
with the people that should be
*consulted*
for the proposal,
for the best. make it clear it's a proposal and that you welcome
typically your team, but can include other stakeholders. this is
changes, ideas, or dissent. give plenty of time for discussion
*not*
the same as your affected users! it's a strict subset and,
in fact, can be a single person (e.g. your team lead). for smaller
decisions, this can be done by email, or, in some case, can be
both: you can present a draft at a meeting, get feedback, and then
send a final proposal by email.
either way, a decision will have a deadline for discussion
(typically not more than two weeks) and grant extensions, if
(typically not more than two weeks) and grant extensions, if
requested and possible. make it clear who makes the call
requested and possible. make it clear who makes the call
("decision-makers" field) and who can be involved ("consulted"
("decision-makers" field) and who can be involved ("consulted"
...
...
...
...