Appearance
End-to-end flows
TODO: One paragraph: which journeys are documented here, and why they matter. Each flow follows one action from the user's click to the final write and back, naming every repository on the way.
Flow index
| Flow | Starts in | Repositories involved | Status |
|---|---|---|---|
| TODO | TODO | TODO | TODO |
TODO: Flow name
Summary
TODO: One or two sentences: who does what, and what they get.
Sequence
rendering diagram…
drag to pan · ctrl / ⌘ + scroll to zoom
Steps
| # | Repository | Component / API | What happens |
|---|---|---|---|
| 1 | TODO | TODO: link | TODO |
| 2 | TODO | TODO: link | TODO |
Failure modes
| Failure | Detected by | User sees | Recovery |
|---|---|---|---|
| TODO | TODO | TODO | TODO |
Adding a flow
Copy the TODO: Flow name section above, add a row to the flow index, and link each step to the component or API page it touches.