adding ticket structure, finishing docker credential helper setup
This commit is contained in:
parent
768ca24eb2
commit
fbb4e59274
4 changed files with 175 additions and 6 deletions
77
documentation/tickets/blueprint.md
Normal file
77
documentation/tickets/blueprint.md
Normal file
|
|
@ -0,0 +1,77 @@
|
|||
# Ticket Blueprint
|
||||
|
||||
Two formats depending on task type. Choose based on whether a meaningful
|
||||
decision between options was made.
|
||||
|
||||
---
|
||||
|
||||
## Format A — ADR (architectural/infrastructural decisions)
|
||||
Use when: you chose between options with long-term consequences.
|
||||
Prefix: `adr-`
|
||||
|
||||
---
|
||||
|
||||
# ADR: <title>
|
||||
|
||||
## Status
|
||||
Accepted | Superseded by | Deprecated
|
||||
|
||||
## Date
|
||||
YYYY-MM-DD
|
||||
|
||||
## Context
|
||||
What is the problem? Why does it need to be solved?
|
||||
|
||||
## Decision
|
||||
What was chosen and why in one or two sentences.
|
||||
|
||||
## Options considered
|
||||
|
||||
### Option A — <name> ✅
|
||||
Description. Why it was chosen.
|
||||
|
||||
### Option B — <name>
|
||||
Description. Why it was rejected.
|
||||
|
||||
## Consequences
|
||||
- What gets better
|
||||
- What gets worse or more complex
|
||||
- Operational implications
|
||||
- What breaks if this needs to be redone
|
||||
|
||||
## Affected files / machines
|
||||
- List files, servers, or systems touched
|
||||
|
||||
## References
|
||||
- Links to relevant docs
|
||||
|
||||
---
|
||||
|
||||
## Setup guide / implementation notes
|
||||
Step-by-step of what was actually done.
|
||||
|
||||
---
|
||||
|
||||
## Format B — Task (features, fixes, chores)
|
||||
Use when: routine task with a clear solution.
|
||||
Prefix: `feat-` / `fix-` / `chore-`
|
||||
|
||||
---
|
||||
|
||||
# <prefix>: <title>
|
||||
|
||||
## Problem
|
||||
What was wrong or missing?
|
||||
|
||||
## Options considered
|
||||
### Option A — <name> ✅
|
||||
### Option B — <name>
|
||||
|
||||
## Solution
|
||||
What was done and why.
|
||||
|
||||
## Files changed
|
||||
- `path/to/file.ts`
|
||||
|
||||
## Commit
|
||||
`<type>: <message>`
|
||||
Loading…
Add table
Add a link
Reference in a new issue