Local workflow#
For the exact repository checks:
Add a feed#
Write the generator
Create feed_generators/<name>.py and publish through the shared writer.
Register it
Add the source to feeds.yaml.
Reuse shared helpers
Use the maintained HTTP, normalization, cache, enrichment and feed helpers rather than cloning them.
Publish it
Add the feed to the public registry/site when appropriate.
Validate
Run tests and feed validation before merging.
Quality contract#
Every enabled feed should produce non-empty parseable XML and a valid JSON Feed 1.1 sidecar with the same item count. Rich metadata such as authors, images or categories is adaptive, not fabricated merely to satisfy a schema.
A weather endpoint, changelog and newsroom do not need identical metadata. Preserve what upstream can truthfully provide, normalize it, and avoid inventing the rest.