About¶

Marginalia — selective research & reading notes, published bilingually. Every note is deposited via issue → PR → squash commit, so the repository history reads like a table of contents.

🌐 This site: https://uniqueclouds.github.io/marginalia/ Each content item — research notes, reports, skills, the podcast guide — is read online here, built with MkDocs Material. A light/dark theme is available.

Two kinds of content¶

Kind	Issue required	Flow	Description
Entry	yes	issue → PR → one squash commit	Research musings and reading notes; bilingual, with full provenance metadata
Artifact	no	direct PR (lives inside its entry's directory)	Live skills, source documents, full reports; published verbatim in their birth language, no translation

Currently on the site:

Entries 001–005: coding-agent aesthetics, writing like Dourish, the NOTUGLY-S proposal, CHI/ACL storytelling quantified, language-style measurement of four disciplines' classic papers.
Artifact 006: Spotify Podcast Guide 2026 — English podcast curation (26 shows / 46 curated episodes, all official links verified).
Each entry also carries companion artifacts (the academic-voices / dourish-style polishing skills, the storytelling originals and proposal, the five full discipline-style reports), each in its own PR on GitHub.

The publishing ritual¶

Issue (entries only) — the musing itself: what triggered it, where the data came from, the original idea;
Pull request — the distilled content: an entry is note.en.md + note.zh.md + one new index row; an artifact can ride its own PR without an issue;
Commit — one squash commit on main per piece, so the history reads like a table of contents.

Data & reproducibility¶

Raw corpora and the working workspace are not published with the repo (default-deny .gitignore; only whitelisted files are committed);
Each entry's sources field lists the local corpora and tools it rests on — readers can trace them;

Site pages are generated by scripts/build_site_pages.py from the marginalia/ working directory, then statically built by mkdocs build — locally reproducible:

python scripts/build_site_pages.py   # generates docs/ entry/podcast/index pages
mkdocs serve                          # preview at http://127.0.0.1:8000/marginalia/

Contact & links¶

Repo: github.com/UniqueClouds/marginalia
Website: https://uniqueclouds.github.io/marginalia/
Author: Yunqi Chen
License: unless otherwise noted, the content of this site and repo is offered under CC BY-NC 4.0 — credit and you're free to use it for any non-commercial purpose; commercial use requires prior permission.

_{Editing this page does not auto-sync the README; if you spot the three descriptions diverging, please tell me in the issue tracker.}