[salmanfarisvp]

Documents how this repo releases, and how to publish and update RSS-based feed apps, in the README.

Releasing

Tag-based releases already work here the same way as in the other Edge App repos. update-edge-app.yml is identical to air-quality-app's (shared update.yml@v26.10.2, v[0-9]* tags), and the feed-app workflow responds to the same tags. The README now says so:

• Merging to main deploys the main app and every feed app to stage.
• One vYY.M.PATCH tag on main deploys all of them to production.

The version format now matches the other repos (vYY.M.PATCH, previously vYY.MM.N here).

Publishing a new feed app

The steps: host an icon, add a deployed-apps.yml entry with empty ids, initialize on stage, record the id, check it, then do the same for production. The example entry leaves out categories, because the workflow doesn't apply it (feed apps are still listed as Utilities).

Updating a feed app

Covers which change goes where:

• Name, description, icon, header title or feed URL: edit deployed-apps.yml.
• Code or other settings: edit the code or screenly.yml. Every feed app picks it up.
• One-off runs: use the manual workflow and its overrides.
• Removing an app from deploys: clear its id.

It also notes that changing app_name after creation doesn't rename the app.

DEPLOYMENT.md

Keeps how the feed-app workflows work and the deployed-apps.yml field reference, and links to the README for the steps, so the two can't drift apart.

[Copilot]

🟢 Approval recommended

The supplied review evidence identifies no unresolved concerns in the changes.

No open issues 🎉

What changed in this PR

This pull request documents release procedures and the lifecycle of publishing and updating RSS feed apps, while keeping DEPLOYMENT.md focused on workflow and configuration references.

Changes:

• Documents stage and production releases using vYY.M.PATCH tags.
• Adds instructions for publishing, updating, testing, and removing feed apps.
• Links deployment configuration guidance to the README.

File	Summary
README.md	Adds release and feed-app lifecycle documentation. Clarify that adding a feed-app entry and merging to main still triggers normal stage deployments, while an app without an ID is skipped and may cause the feed-app workflow to report “No apps to deploy.”
DEPLOYMENT.md	Retains workflow and configuration context while linking to the README for operational procedures.
deployed-apps.yml	Updates the configuration comment to direct contributors to the README.

This pull request requires changes.

_{Review effort: Lite}