[#5] Add MAINTAINING.md - public distribution runbook for maintainers #6
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/5-public-distribution-runbook"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Closes #5
What this adds
MAINTAINING.md— the maintainer runbook for the public workbench distribution.Documentation only; no behaviour change.
Why it is needed
Nothing about this setup is self-evident from the code or the Forgejo UI. In particular:
internalvisibility is derived, not a setting — the settings page shows a Privatecheckbox that was already unchecked while the repo was unreachable. Anyone who looks at
the UI will conclude nothing is wrong.
PATCHthat returns HTTP 200 can change nothing at all.cggsilently breaks public access with no error visibleanywhere in the UI.
releases/latest/download/...does not work on this instance.Each of those cost real time to establish. Without a written record they get re-derived.
Contents
comfac-distand must not move backReviewer note
§6.1 is the one to read even if nothing else: the updater installs missing workbenches
only and never updates existing installs — the
versionfield inmanifest.jsonisnever read. Publishing a new release therefore reaches new users only. That is the
highest-value follow-up work and is deliberately flagged rather than quietly fixed here.
Deliberately free of internal filesystem paths and credential locations, since this
repository is public.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.Merge
Merge the changes and update on Forgejo.Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.