Repository navigation
Description
Scope
48 screenshot files exist in static/img/ but are not referenced from any English doc. In many cases the file looks like a per-step screenshot that should be wired into a doc currently using a generic list view as a placeholder — i.e. a fix that requires only markdown edits, not a new capture. This is the "quick wins" issue: walk the list, decide one of three actions per file.
Per file, decide:
- Wire in — the file is accurate for the current UI and there is a clear doc spot that should reference it. Just edit the markdown.
- Re-capture — the file is a stale capture of the right screen. Overwrite with a fresh capture from
wordpress.local:8080(see master playbook) and wire it in. - Delete — the file documents an obsolete UI that no longer exists, or duplicates another file that's already in use.
Orphan list grouped by likely action
Likely "wire in" (right file, just unreferenced)
The descriptive filenames make these very likely to be the correct per-step screenshots that should have been used instead of the generic list views currently in the docs:
-
static/img/admin/broadcast-edit.png— referenced fromsending-emails-and-broadcasts.md? -
static/img/admin/customer-edit.png— referenced fromclient-websites.md/ customer detail. -
static/img/admin/domain-edit.png— referenced fromhow-to-configure-domain-mapping.md(domain detail section). -
static/img/admin/membership-edit.pngandmembership-edit-full.png— referenced frommanaging-memberships.md,upgrading-a-plan.md, etc. -
static/img/admin/payment-edit.pngandpayment-edit-full.png— referenced fromgetting-paid.md,manual-payments.md. -
static/img/admin/site-edit-full.png— referenced fromclient-websites.md. -
static/img/admin/webhook-edit.png— referenced fromwebhooks.md. -
static/img/config/checkout-form-delete.png— referenced fromcheckout-forms.md. -
static/img/config/checkout-form-editor-overview.png— referenced fromcheckout-forms.mdandcustomizing-your-registration-form.md. -
static/img/config/checkout-frontend-registration.png— referenced fromthe-registration-flow.md. -
static/img/config/discount-code-active.png—creating-discount-codes.md. -
static/img/config/discount-code-advanced.png—creating-discount-codes.md. -
static/img/config/discount-code-description.png—creating-discount-codes.md. -
static/img/config/discount-code-edit.png—creating-discount-codes.md. -
static/img/config/discount-code-save.png—creating-discount-codes.md. -
static/img/config/discount-codes-empty.png—creating-discount-codes.md. -
static/img/config/frontend-checkout-pricing-table.png—the-registration-flow.md/checkout-forms.md. -
static/img/config/period-selection-field-options.png—checkout-forms.md. -
static/img/config/pricing-table-force-durations.png—checkout-forms.md. -
static/img/config/product-hide-credits.png—creating-your-first-subscription-product.md(Whitelabel tab). -
static/img/config/product-price-variations.png— product pricing section. -
static/img/config/site-template-description.png—site-templates.md. -
static/img/config/site-template-edit.png—site-templates.md.
Likely "the canonical 'full page' variant"
These *-full.png variants probably go alongside the cropped versions for the longer "complete page reference" sections of each settings page:
-
static/img/admin/network-dashboard-full-page.png -
static/img/admin/settings-emails-full.png -
static/img/admin/settings-general-full.png -
static/img/admin/settings-payments-bottom.png -
static/img/admin/settings-payments-full.png -
static/img/admin/settings-sites-full.png -
static/img/admin/um-dashboard-bottom.png -
static/img/admin/um-dashboard-full.png -
static/img/config/settings-api-full.png -
static/img/config/settings-domain-mapping-full.png -
static/img/config/settings-emails-full.png -
static/img/config/settings-general-full.png -
static/img/config/settings-login-registration-full.png -
static/img/config/settings-membership-full.png -
static/img/config/settings-payments-full.png -
static/img/config/settings-sites-full.png -
static/img/config/settings-taxes-full.png -
static/img/config/settings-whitelabel-full.png
Likely "uncategorised yet — decide per file"
-
static/img/admin/addons-list.png(vs already-usedaddons-page.png). -
static/img/admin/system-info.png. -
static/img/config/settings-membership.png(membership settings page that no doc references). -
static/img/config/settings-whitelabel.png. -
static/img/config/shortcodes-page.png.
Acceptance criteria
- Every orphan in the list is either wired into a doc, re-captured + wired in, or deleted with a one-line rationale in the PR description.
- After this issue is closed,
git ls-files 'static/img/*'minus referenced files (see the audit script in the master issue) returns only images that are intentionally available for future docs.
Audit script
python3 - <<'PY'
import re, subprocess
files = subprocess.check_output(['git','ls-files'], text=True).split()
imgs = [f for f in files if f.startswith('static/img/') and f.split('.')[-1].lower() in ('png','jpg','jpeg','gif','webp')]
docs = [f for f in files if f.startswith('docs/') and (f.endswith('.md') or f.endswith('.mdx'))]
text = ''
for d in docs:
try:
text += open(d).read() + '\n'
except Exception:
pass
for img in imgs:
rel = img.replace('static','')
if rel not in text and img.split('/')[-1] not in text:
print(img)
PYTracked by: master screenshot audit issue.
aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.
Activity
superdav42 commentedon May 19, 2026
Part of the screenshot audit tracked in #78 — see that issue for the shared capture playbook (wordpress.local:8080 / admin / admin, viewport, seed-data, file-naming conventions).
aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.
superdav42 commentedon May 19, 2026
For #64. This issue is a net-new finding from the parallel audit pass that produced the gap analysis at #64 (comment).
Note: many of the listed orphans are exactly the per-step screenshots that the gap pages (especially
creating-discount-codes.mdfor thediscount-code-*.pngfamily) currently need. Doing this issue first turns several of the per-page gap fixes into markdown-only edits.superdav42 commentedon May 20, 2026
DISPATCH_CLAIM nonce=4ee8d604e05dc6495670331d5686f03d runner=superdav42 ts=2026-05-20T04:56:36Z max_age_s=1800 version=3.17.1 opencode_version=1.15.5
superdav42 commentedon May 20, 2026
Dispatching worker (deterministic).
superdav42 commentedon May 20, 2026
CLAIM_RELEASED reason=worker_failed runner=dave ts=2026-05-20T04:57:47Z aidevops_version=3.17.1 opencode_version=1.15.5
superdav42 commentedon May 20, 2026
DISPATCH_CLAIM nonce=de5c14e8e3d80759bcc7e9ddd18359ed runner=superdav42 ts=2026-05-20T05:01:00Z max_age_s=1800 version=3.17.1 opencode_version=1.15.5
superdav42 commentedon May 20, 2026
Dispatching worker (deterministic).
superdav42 commentedon May 20, 2026
CLAIM_RELEASED reason=worker_complete runner=dave ts=2026-05-20T05:07:32Z aidevops_version=3.17.1 opencode_version=1.15.5