Atom feeds for new and changed guides (#104) #116

Merged
miko merged 2 commits from feature/104-atom-feed into development 2026-11-05 15:05:52 +01:00
Owner

Closes #104.

  • /feed is the instance's Atom feed; /feed/<category path> a category's, including its subcategories. A missing category, or one hidden from guests, answers 404.
  • One entry per guide, made from its latest version: title, cover image, description, who published it and when, with the version's change note in the summary. The first version's time is the entry's publishing date. Saved changes to a working copy never show.
  • Only guides with public effective visibility, the 50 most recently published.
  • Every page links the instance's feed in its head; public category pages also link their own.
  • feed is now an app route name and so a reserved page slug. GLOSSARY gains Feed; CHANGELOG updated.

Tests: unit tests for selection (src/feeds/selection.test.ts) and Atom rendering (src/feeds/atom.test.ts), e2e in e2e/feed.spec.ts. Typecheck, lint, 452 unit and 60 e2e tests pass.

Open questions:

  • Unpublishing and republishing a guide unchanged adds no version, so its entry comes back with its old date.
  • A guide moved to another category appears in that feed with its old date.
  • For guides whose first version was backfilled at server start (#106), the entry's publishing date is their last edit.

🤖 Generated with Claude Code

Closes #104. - `/feed` is the instance's Atom feed; `/feed/<category path>` a category's, including its subcategories. A missing category, or one hidden from guests, answers 404. - One entry per guide, made from its latest version: title, cover image, description, who published it and when, with the version's change note in the summary. The first version's time is the entry's publishing date. Saved changes to a working copy never show. - Only guides with public effective visibility, the 50 most recently published. - Every page links the instance's feed in its head; public category pages also link their own. - `feed` is now an app route name and so a reserved page slug. GLOSSARY gains **Feed**; CHANGELOG updated. Tests: unit tests for selection (`src/feeds/selection.test.ts`) and Atom rendering (`src/feeds/atom.test.ts`), e2e in `e2e/feed.spec.ts`. Typecheck, lint, 452 unit and 60 e2e tests pass. Open questions: - Unpublishing and republishing a guide unchanged adds no version, so its entry comes back with its old date. - A guide moved to another category appears in that feed with its old date. - For guides whose first version was backfilled at server start (#106), the entry's publishing date is their last edit. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
/feed lists newly published and changed guides of the whole instance,
/feed/<category path> those of a category and its subcategories, e.g. to
post them into a Matrix or Discord channel. Each guide is one entry, made
from its latest version: title, cover image, description, who published it
and when, with the version's change note in the summary; its first
version's time is the entry's publishing date. Saved changes to a working
copy never show. Only guides a guest may see appear (public effective
visibility), the 50 most recently published; a category that is missing
or hidden from guests answers 404.

Every page links the instance's feed in its head for feed readers, a
public category page also its own. "feed" becomes an app route name and so
a reserved page slug. GLOSSARY gains Feed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
miko merged commit 8524a82a25 into development 2026-11-05 15:05:52 +01:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba!116
No description provided.