Skip to content

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

Closed

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.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-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.

Activity

  1. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    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.

  2. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    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.md for the discount-code-*.png family) currently need. Doing this issue first turns several of the per-page gap fixes into markdown-only edits.

  3. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    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

  4. self-assigned this
    on May 20, 2026
  5. locked as resolved and limited conversation to collaborators on May 20, 2026
  6. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    Dispatching worker (deterministic).

  7. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=worker_failed runner=dave ts=2026-05-20T04:57:47Z aidevops_version=3.17.1 opencode_version=1.15.5

  8. added and removed
    status:queuedWorker dispatched, not yet started
    on May 20, 2026
  9. unlocked this conversation on May 20, 2026
  10. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    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

  11. added
    status:queuedWorker dispatched, not yet started
    and removed on May 20, 2026
  12. locked as resolved and limited conversation to collaborators on May 20, 2026
  13. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    Dispatching worker (deterministic).

  14. added
    status:in-reviewNon-draft PR ready for review/merge
    and removed
    status:queuedWorker dispatched, not yet started
    on May 20, 2026
  15. unlocked this conversation on May 20, 2026
  16. superdav42 commented on May 20, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=worker_complete runner=dave ts=2026-05-20T05:07:32Z aidevops_version=3.17.1 opencode_version=1.15.5

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationgood first issueGood for newcomersstatus:in-reviewNon-draft PR ready for review/merge

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions