Everything under this directory is published verbatim to https://juanalonso.com via obsidian-export (see .github/workflows/z_reusable_publish_blog.yml). Assume anything written here is public.

AGENTS.md files are pruned from the export, so this file is not published. Any other file added here is.

Writing or editing notes in sources/

Read Efforts/Not Blogs/juanalonso.com maintenance/Book Note Policy.md (not published) before creating or substantially editing any note in sources/. It defines which books, films, and series earn a note at all, the three tiers, and the writing rules. Do not add a note for a source just because it was read or watched: the completeness log is misc/Book Reviews.md and misc/Movie Reviews.md.

Related, all at the vault root:

• x/Templates/Source Note.md — the template for a new source note
• checklists/reading-v2.md — the reading protocol (steps I execute)
• checklists/syntopical-questions.md — cross-source questions

Conventions

• Frontmatter is required: title, date, lastmod, summary, tags, url. source_date, thumbnail, status where they apply.
• url is a stable permalink. Never change one on an existing note; the site has redirect checks in scripts/check_redirects.sh in the hugo repo.
• Working notes go under a # !WORKING heading. Everything from that heading to the end of the file is stripped at publish time, so scratch material can stay in the note while drafting. Renders normally in Obsidian.
• %%...%% does NOT hide anything from the site: obsidian-export passes it through and it reaches the live HTML. Do not use it for anything private.
• Attachments go in attachments/<section>/, referenced with wikilinks.