Fable clean up

README.md

@@ -2,7 +2,7 @@
 
 Engineering writeups by Andras Schmelczer: finished projects with the design constraints left in. Built with Astro, no required client JavaScript.
 
-Articles live in `src/content/posts`, project index entries in `src/content/projects`, and normal pages are rendered as static HTML.
+All content lives in the single `src/content/work` collection: each entry can carry an `article` facet (a page under `/articles/`), a `project` facet (a card on `/projects/`), or both. Normal pages are rendered as static HTML.
 
 ## Setup
 
@@ -11,6 +11,8 @@ npm ci
 npx playwright install --with-deps chromium # required before Playwright QA checks
 ```
 
+The `overrides.yaml` entry in `package.json` forces every transitive `yaml` dependency to 2.9+, ahead of what some Astro tooling requests on its own. Drop it once `npm ls yaml` shows nothing older without it.
+
 ## Commands
 
 ```sh
@@ -23,11 +25,11 @@ npm run qa
 
 ## Structure
 
-- `src/content/posts`: Markdown articles
-- `src/content/projects`: project index entries
+- `src/content/work`: Markdown entries (article and/or project facets)
 - `src/pages`: static routes
 - `src/layouts`: page and post layouts
 - `src/components`: reusable UI pieces
 - `src/styles/global.css`: the visual system
+- `scripts`: QA checks run by `npm run qa` (shared helpers in `scripts/lib`)
 - `public/media/downloads`: CV and thesis PDFs
 - `public/media/video`: project videos