Merge pull request 'docs: correct admin-credentials help text (fixes #34 )' (#35 ) from docs/admin-creds-help-text into main

docs: address review — make S3/B2/SFTP/local guidance actionable
The previous wording told operators to leave the slot blank and then warned that doing so disables prune, which is contradictory. Prune is gated on the admin slot for every backend, on both paths: scheduled (maintenance_dispatch.go:52) skips silently, manual (repo_ops.go:39) returns 400 admin_creds_required. Also reworded the opening line, which still said 'only needed for rest-server repos' while the new text asks other backends to fill it in.
2026-08-21 22:39:04 +01:00 · 2026-08-21 22:36:14 +01:00 · 2026-08-21 21:01:39 +01:00
1 changed files with 8 additions and 4 deletions
@@ -82,10 +82,14 @@
        <div class="text-[12px] text-ok mb-3 mono">✓ saved</div>
      {{end}}
      <p class="text-[12.5px] text-ink-mid leading-[1.6] mb-4 max-w-[640px]">
-        Only needed for rest-server repos that distinguish an append-only
+        Required for prune. On rest-server repos this is the
-        user (everyday backups) from a delete-capable user (prune /
+        delete-capable user, as distinct from the append-only user used
-        forget). For S3 / B2 / SFTP / local, leave this blank — the
+        for everyday backups. Note that <strong>forget</strong> always
-        everyday repo credentials handle prune too.
+        runs with the everyday repo credentials, so those must have
        delete authority. For S3 / B2 / SFTP / local, enter the same
        delete-capable repository credentials here if you want prune
        enabled. <strong>Prune is skipped when admin credentials are
        unset</strong>, on any backend.
      </p>
      <div class="grid grid-cols-2 gap-4">
        <div>
Author	SHA1	Message	Date
steve	27be28ee9c	Merge pull request 'docs: correct admin-credentials help text (fixes #34 )' (#35 ) from docs/admin-creds-help-text into main	2026-08-21 22:39:04 +01:00
Steve Cliff	a8a6fdfab5	docs: address review — make S3/B2/SFTP/local guidance actionable CI / Test (store) (pull_request) Successful in 37s Details CI / Test (rest) (pull_request) Successful in 48s Details CI / Build (windows/amd64) (pull_request) Successful in 8s Details CI / Lint (pull_request) Successful in 20s Details CI / Build (linux/arm64) (pull_request) Successful in 24s Details CI / Build (linux/amd64) (pull_request) Successful in 26s Details CI / Test (server-http) (pull_request) Successful in 1m37s Details e2e / Playwright vs docker-compose (pull_request) Successful in 1m16s Details The previous wording told operators to leave the slot blank and then warned that doing so disables prune, which is contradictory. Prune is gated on the admin slot for every backend, on both paths: scheduled (maintenance_dispatch.go:52) skips silently, manual (repo_ops.go:39) returns 400 admin_creds_required. Also reworded the opening line, which still said 'only needed for rest-server repos' while the new text asks other backends to fill it in.	2026-08-21 22:36:14 +01:00
Steve Cliff	e9df802478	docs: correct admin-credentials help text CI / Test (rest) (pull_request) Successful in 1m42s Details CI / Test (store) (pull_request) Successful in 1m45s Details CI / Lint (pull_request) Successful in 28s Details CI / Build (windows/amd64) (pull_request) Successful in 29s Details CI / Test (server-http) (pull_request) Successful in 2m27s Details CI / Build (linux/amd64) (pull_request) Successful in 30s Details CI / Build (linux/arm64) (pull_request) Successful in 26s Details e2e / Playwright vs docker-compose (pull_request) Successful in 1m30s Details Forget does not use admin credentials. Only JobPrune builds a runner against the admin slot (cmd/agent/main.go:622-645); JobForget runs on the everyday runner, as the comment at main.go:517-524 states. Also corrects the claim that leaving this blank lets everyday creds handle prune: maintenance_dispatch.go:52-56 skips prune entirely with 'prune skipped — no admin creds' on any backend, with no fallback. Refs #34	2026-08-21 21:01:39 +01:00