Skip to content

Screenshots: rewire 48 orphan files under static/img (quick markdown-only wins) #85

@superdav42

Description

@superdav42

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:

  1. 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.
  2. 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.
  3. 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 from sending-emails-and-broadcasts.md?
  • static/img/admin/customer-edit.png — referenced from client-websites.md / customer detail.
  • static/img/admin/domain-edit.png — referenced from how-to-configure-domain-mapping.md (domain detail section).
  • static/img/admin/membership-edit.png and membership-edit-full.png — referenced from managing-memberships.md, upgrading-a-plan.md, etc.
  • static/img/admin/payment-edit.png and payment-edit-full.png — referenced from getting-paid.md, manual-payments.md.
  • static/img/admin/site-edit-full.png — referenced from client-websites.md.
  • static/img/admin/webhook-edit.png — referenced from webhooks.md.
  • static/img/config/checkout-form-delete.png — referenced from checkout-forms.md.
  • static/img/config/checkout-form-editor-overview.png — referenced from checkout-forms.md and customizing-your-registration-form.md.
  • static/img/config/checkout-frontend-registration.png — referenced from the-registration-flow.md.
  • static/img/config/discount-code-active.pngcreating-discount-codes.md.
  • static/img/config/discount-code-advanced.pngcreating-discount-codes.md.
  • static/img/config/discount-code-description.pngcreating-discount-codes.md.
  • static/img/config/discount-code-edit.pngcreating-discount-codes.md.
  • static/img/config/discount-code-save.pngcreating-discount-codes.md.
  • static/img/config/discount-codes-empty.pngcreating-discount-codes.md.
  • static/img/config/frontend-checkout-pricing-table.pngthe-registration-flow.md / checkout-forms.md.
  • static/img/config/period-selection-field-options.pngcheckout-forms.md.
  • static/img/config/pricing-table-force-durations.pngcheckout-forms.md.
  • static/img/config/product-hide-credits.pngcreating-your-first-subscription-product.md (Whitelabel tab).
  • static/img/config/product-price-variations.png — product pricing section.
  • static/img/config/site-template-description.pngsite-templates.md.
  • static/img/config/site-template-edit.pngsite-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-used addons-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)
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.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationgood first issueGood for newcomersstatus:in-reviewPR open, awaiting review/merge

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions