-
Notifications
You must be signed in to change notification settings - Fork 74
doc: added adr template (#1383) #1408
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
The created documentation from the pull request is available at: docu-html |
chheis
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looks good to me
hth9fe
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please consider as mentioned in my review comment to specify the full list of Status values and rethink if Description would be more common then Context.
Other than this I'm fine.
aschemmel-tech
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
see inline comments
| # SPDX-License-Identifier: Apache-2.0 | ||
| # ******************************************************************************* | ||
| .. _adr-template: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A template is a process document and should therefore be documented in process_description repo.
| .. container:: adr-template | ||
|
|
||
| +--------------------------------------------------+ | ||
| | **ID** | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
unclear, do you mean to document these attributes in the need and in the table two times?
| :status: proposed | ||
| :context: Describe the issue or motivation behind this decision or change. | ||
| :decision: Detail the proposed change or decision. | ||
| :consequences: Explain the impact of this change, including what becomes easier or more difficult. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How is the linking to architecture needs done? I.e. which architecture does this decision cover?
| .. toctree:: | ||
|
|
||
| stakeholder/index | ||
| adr/index |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This implies to me that these decisions are on stakeholder/platform level. Is this intended?
|
@aschemmel-tech is that now been replaced by eclipse-score/process_description#155? |
yes, in my opinion this PR (#1408) can be closed now |
see #1383
Frank Scholter Peres frank.scholter_peres@mercedes-benz.com, Mercedes-Benz Tech Innovation GmbH
Provider Information