Source Notes
This directory stores the reusable evidence behind the convention docs.
What belongs here
One note per upstream repo, with:
- why the repo was chosen
- repeated conventions, not just isolated examples
- caveats and counterexamples
- exact
file:lineanchors - pattern candidates supported by the evidence
Current notes
fastapi.mdstarlette.mdpydantic.mdhttpx.mdfastapi-users.mdfull-stack-fastapi-template.md
Quality bar
A source note is good when it makes later synthesis cheap:
- repeated patterns are clearly separated from one-off examples
- framework-owned caveats are preserved
- citations are fast to verify
- vague claims are trimmed away
Read ../PROCESS.md for the full repeatable workflow.