Initial extracted documentation set

2026-06-01 21:42:05 +00:00
commit 60ffec18e4
17 changed files with 1590 additions and 0 deletions
@@ -0,0 +1,32 @@
+# Source Notes
+
+This directory stores the reusable evidence behind the pattern docs.
+
+## What belongs here
+
+One note per upstream repo, with:
+- why the repo is useful
+- repeated patterns, not a reading diary
+- caveats and counterexamples
+- exact `file:line` anchors
+- pattern candidates supported by the evidence
+
+## Current notes
+
+- `cpython.md`
+- `httpx.md`
+- `pytest.md`
+- `pydantic.md`
+- `attrs.md`
+- `click.md`
+- `sqlalchemy.md`
+
+## Quality bar
+
+A source note is good when it makes later synthesis cheap:
+- repeated evidence is separated from one-off examples
+- vague claims are avoided
+- citations are fast to verify
+- caveats survive instead of being flattened away
+
+Read `../PROCESS.md` for the full repeatable workflow.