mirror of
https://github.com/photoprism/photoprism.git
synced 2026-07-17 16:49:04 +00:00
Docs: Clarify checking off met Acceptance Criteria in GitHub issues
This commit is contained in:
parent
1350d9fe85
commit
c650f38f18
2 changed files with 8 additions and 0 deletions
|
|
@ -27,6 +27,10 @@ Descriptions MUST conclude with a checklist of **Acceptance Criteria**:
|
|||
- `MUST` — required for the issue to be considered complete
|
||||
- `SHOULD` — strongly recommended but not strictly required
|
||||
- `MAY` — optional enhancement
|
||||
- Keep the checklist current: once the work for a criterion is implemented **and verified**, mark it done (`- [x]`).
|
||||
- Leave items that are unverified, not yet implemented, or skipped optional (`MAY`) enhancements unchecked.
|
||||
- An issue is complete only when every `MUST` is checked; never tick a box on the strength of a plan alone or an unrun test.
|
||||
- When referencing an issue from a commit that fulfills some of its criteria, update the matching boxes first.
|
||||
|
||||
> Agents MUST create, edit, close, reopen, relabel, or otherwise modify GitHub issues only when explicitly requested by the user.
|
||||
|
||||
|
|
|
|||
|
|
@ -54,6 +54,10 @@ Optional nested repositories such as `plus/`, `pro/`, `portal/`, and `specs/` ma
|
|||
- Use level-3 Markdown headings for sections within issue descriptions, for example `### Acceptance Criteria`.
|
||||
- Follow with behavior, rationale, technical considerations, and constraints.
|
||||
- End with `- [ ]` checklist items for the acceptance criteria, each using `MUST`, `SHOULD`, or `MAY`.
|
||||
- Keep the checklist current: once the work for a criterion is implemented **and verified**, mark it done (`- [x]`).
|
||||
- Leave items that are unverified, not yet implemented, or skipped optional (`MAY`) enhancements unchecked.
|
||||
- An issue is complete only when every `MUST` is checked; never tick a box on the strength of a plan alone or an unrun test.
|
||||
- When referencing an issue from a commit that fulfills some of its criteria, update the matching boxes first.
|
||||
- Agents MUST create, edit, close, reopen, relabel, or otherwise modify GitHub issues only when explicitly requested by the user.
|
||||
|
||||
### Specifications & Documentation
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue