Initial extracted documentation set

2026-06-01 21:42:05 +00:00
commit a23e494026
16 changed files with 1414 additions and 0 deletions
@@ -0,0 +1,31 @@
+# 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:line` anchors
+- pattern candidates supported by the evidence
+
+## Current notes
+
+- `fastapi.md`
+- `starlette.md`
+- `pydantic.md`
+- `httpx.md`
+- `fastapi-users.md`
+- `full-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.