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:
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:
Likely "uncategorised yet — decide per file"
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)
PY
Tracked 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.
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:
wordpress.local:8080(see master playbook) and wire it in.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.pngvariants probably go alongside the cropped versions for the longer "complete page reference" sections of each settings page:static/img/admin/network-dashboard-full-page.pngstatic/img/admin/settings-emails-full.pngstatic/img/admin/settings-general-full.pngstatic/img/admin/settings-payments-bottom.pngstatic/img/admin/settings-payments-full.pngstatic/img/admin/settings-sites-full.pngstatic/img/admin/um-dashboard-bottom.pngstatic/img/admin/um-dashboard-full.pngstatic/img/config/settings-api-full.pngstatic/img/config/settings-domain-mapping-full.pngstatic/img/config/settings-emails-full.pngstatic/img/config/settings-general-full.pngstatic/img/config/settings-login-registration-full.pngstatic/img/config/settings-membership-full.pngstatic/img/config/settings-payments-full.pngstatic/img/config/settings-sites-full.pngstatic/img/config/settings-taxes-full.pngstatic/img/config/settings-whitelabel-full.pngLikely "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
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
Tracked 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.