Skip to content

consolidated: screenshot audit and refresh program #191

Open

Description

@superdav42

Supersedes #64 — this issue is the consolidated spec.

What

Run the repository-wide Screenshot Audit and Refresh Program. Every documentation screenshot must depict the UI described beside it, be unique to that concept, tightly cropped to the relevant control, readable, and optimized for the documentation site. Deliver the work through the already-filed child issues; retain this issue as the program tracker.

Program inventory and delivery structure

Why

The audit found screenshots reused for unrelated concepts, including walkthroughs where one placeholder illustrates every step. This makes instructions misleading, conceals current product UI, and adds unnecessary static assets. The program replaces placeholders with accurate shots, wires in useful orphan captures before taking new ones, and keeps images fast and consistent.

How

Capture and asset standards

Requirement Standard
Capture viewport 1280 × 800 at device-pixel-ratio 1 and browser zoom 100%
Admin appearance Default WordPress admin colour scheme; no admin-bar customisation
Format 8-bit RGB, non-interlaced PNG
Size Longest edge no more than 1568 px; normally target under 200 KB
Readability Text remains at least 12 px after cropping
Crop Tight panel/section crop; include WordPress chrome only when the docs discuss it
Annotation None unless the existing documentation requires it
Naming Preserve replacement names; new captures use kebab-case-area-element.png under the matching static/img/admin/, static/img/config/, or static/img/installation/ directory
Optimization Run pngquant --quality=70-90 --skip-if-larger -f -o out.png in.png or oxipng -o 4 in.png before commit

Capture against the current Ultimate Multisite main build in the authorized local WordPress environment. Use authorized credentials without recording them in commits, comments, screenshots, or issues. Standard tools include Flameshot/GNOME Screenshot, macOS Screenshot, or a headed Playwright/Chromium window configured to the capture viewport. Rename macOS screenshots to ASCII before committing; the default name can contain a narrow no-break space. Do not retain default Screenshot … AM/PM.png names.

Per-child workflow

  1. Re-create or open the screen described by the target documentation text.
  2. Capture to the exact existing asset path, or add the narrowly named new asset path stated by the child issue.
  3. For a split walkthrough, update the listed Markdown/MDX references to the new per-step captures.
  4. Optimize the image, run npm start, visit the target documentation page, and verify every image renders and matches the adjacent text.
  5. Commit with docs(screenshots): refresh <area> per issue #<N> and open a PR for the child issue.

Audit findings and assigned children

Exact duplicate asset groups

The following MD5-equal groups must become concept-specific captures through their assigned children:

Duplicate group Paths Child
9 product limitation tabs static/img/config/product-{custom-domains,disk-space,hide-credits,plugins,post-types,reset-limitations,site-templates,themes,upgrades}.png (28,236 B each) #69
7 dashboard views static/img/admin/network-dashboard-{activity-stream,first-steps,full,news,right-now,summary}.png, static/img/installation/network-dashboard.png (125,540 B each) #70
3 payment settings shots static/img/admin/settings-payments-{bottom,gateways-2,options}.png #71
2 period-selection views static/img/config/period-selection-field-{options,settings}.png #72
2 installation shots static/img/installation/plugin-activated.png, static/img/installation/wizard-welcome.png #75
2 dashboard shots static/img/admin/um-dashboard-bottom.png, static/img/admin/um-dashboard-stats.png #76

Placeholder walkthroughs already covered

High-reuse images and the corresponding program work

/img/admin/webhooks-list.png is referenced 35 times (#65, #74); /img/config/settings-payment-gateways.png 34 times (#66, #67); /img/admin/memberships-list.png 17 times; /img/config/checkout-form-step.png 16 times (#72, #73); /img/config/settings-taxes.png 15 times; and /img/config/discount-codes-list.png 14 times. The last four are resolved by the child issues below or future focused work, not by a blanket asset replacement.

Gap-page children from the second audit

Use these exact page-level findings when executing #86–#96. The line references were recorded on the audit revision; verify current context before editing.

Child Documentation file Required distinct captures
#86 docs/user-guide/payment-gateways/getting-paid.md Replace 18 placeholders: settings-payment-gateways.png at L16,22,26,30,34,36,42 for payment rows/toggles/invoice settings, and settings-general.png at L62,66,70,74,78,86,90,94,102,106,110 for WooCommerce, GoCardless, and Payfast install dialogs.
#87 docs/user-guide/payment-gateways/manual-payments.md Replace three settings-payment-gateways.png uses (manual toggle, frontend instructions, Thank You page) and three payments-list.png uses (list, detail, status change/activate-membership). Check reusable orphans before recapture.
#88 docs/user-guide/payment-gateways/tax-handling.md Replace 15 settings-taxes.png uses (L18,26,38,42,52,54,58,60,80,84,86,90,94,102,110): tax toggles/rates/categories, VAT add-on install and activation, VAT support, EU rate pull, and frontend VAT field.
#89 docs/user-guide/configuration/creating-discount-codes.md Replace 14 discount-codes-list.png uses (L16,22,24,28,36,40,44,50,54,64,66,70,74,78). First assess and wire accurate orphan assets discount-code-edit.png, discount-code-active.png, discount-code-advanced.png, discount-code-description.png, discount-code-save.png, and discount-codes-empty.png.
#90 docs/user-guide/configuration/the-registration-flow.md Replace 9 uses across checkout-forms-list.png (L20), checkout-form-editor.png (L26,32), settings-payment-gateways.png (L46,50,54), and payments-list.png (L60,64,66,70); include customer registration, Thank You page, activation, manual payment, and admin payment processing.
#91 docs/user-guide/client-management/upgrading-a-plan.md Replace 5 memberships-list.png placeholders (customer account, membership change, plan checkout, upgrade summary, no-change state) and 3 product-upgrades.png placeholders (admin up/downgrades and plan-group assignment).
#92 docs/user-guide/client-management/canceling-a-membership.md Replace 6 memberships-list.png usages (L16,20,24,26,30; two images on L30) with customer Danger Zone, confirmation, logged-out, cancellation, and retained-customer states.
#93 docs/user-guide/client-management/downgrading-a-plan.md Replace 3 memberships-list.png shots (change control, plans, pending-change) and settings-sites.png (post-limit options).
#94 docs/user-guide/client-management/client-websites.md Replace 6 customers-list.png shots (L12,18,22,26,30,34) with customer My Sites, account menu, default-site selection, dropdown, and confirmation.
#95 docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md Replace 7 settings-domain-mapping.png and 9 domains-list.png placeholders: sunrise wizard, mapping controls, redirects/user access, product custom-domain choice, integration/hosting, domains list/add modal/transitions/detail, and subsite controls.
#96 docs/user-guide/miscellaneous/sending-emails-and-broadcasts.md Replace 9 broadcasts-list.png uses (customer notice, menu, add modal as message/email, targeting, editor) and 5 settings-emails.png uses (Emails settings, customization, reset/import/options).

Additional program scope and decisions

Audit reproducibility

Use the following checks when reassessing a target area:

git ls-files | grep -iE '\.(png|jpg|jpeg|gif|webp)$'
find static/img -type f -name '*.png' -exec md5sum {} \; | sort | uniq -d -w 32
grep -rohE '/img/[^)" ]+\.png' docs/ | sort | uniq -c | sort -rn
find static/img -name '*.png' -exec file {} \;

Acceptance Criteria

Context & Decisions

Contributors

cc @superdav42

Files Scope

Hard boundaries: This is a coordination tracker. It authorizes no direct repository-file changes; source and asset edits belong only to the explicitly linked child issues.

AI brief owner: Pulse consolidation workflow.


aidevops.sh v3.34.13 plugin for OpenCode v1.18.31 with gpt-5.6-terra

Activity

  1. added
    documentationImprovements or additions to documentation
    enhancementNew feature or request
    help wantedExtra attention is needed
    origin:workerCreated by headless/pulse worker session
    consolidatedIssue superseded by a consolidated child
    on Oct 12, 2026
  2. locked as resolved and limited conversation to collaborators on Oct 12, 2026
  3. superdav42 commented on Oct 12, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_CLAIM nonce=cd59a0378a855f34e9618cccd64bfb04 runner=superdav42 ts=2026-10-12T23:44:32Z max_age_s=1800 version=3.39.25 opencode_version=1.18.31 lease_token=cd59a0378a855f34e9618cccd64bfb04 device=device-1783824528-2609248-26808 session=issue-191 phase=prelaunch expires_at=1791848794

  4. superdav42 commented on Oct 12, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_LEASE phase=prelaunch lease_token=cd59a0378a855f34e9618cccd64bfb04 device=device-1783824528-2609248-26808 session=issue-191 expires_at=1791849139 ts=2026-10-12T23:44:49Z attempt_id=attempt:b9df3e56-59a6-4469-bed3-4d5b762202e6

  5. superdav42 commented on Oct 12, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_LEASE phase=prelaunch lease_token=cd59a0378a855f34e9618cccd64bfb04 device=device-1783824528-2609248-26808 session=issue-191 expires_at=1791849140 ts=2026-10-12T23:45:50Z attempt_id=attempt:b9df3e56-59a6-4469-bed3-4d5b762202e6

  6. superdav42 commented on Oct 12, 2026

    @superdav42
    ContributorAuthor

    Dispatching worker (deterministic).

  7. 150 remaining items

  8. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_CLAIM nonce=d7f6a9cb05f33c19ab92ccb78c4a4e8a runner=superdav42 ts=2026-11-04T18:26:57Z max_age_s=1800 version=3.39.119 opencode_version=1.18.31 lease_token=d7f6a9cb05f33c19ab92ccb78c4a4e8a device=device-1783824528-2609248-26808 session=issue-191 phase=prelaunch expires_at=1793816940

  9. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_LEASE phase=prelaunch lease_token=d7f6a9cb05f33c19ab92ccb78c4a4e8a device=device-1783824528-2609248-26808 session=issue-191 expires_at=1793817290 ts=2026-11-04T18:27:20Z attempt_id=attempt:9cb98254-50cc-47a0-b055-d17971f9a551

  10. added
    status:queuedWorker dispatched, not yet started
    and removed on Nov 4, 2026
  11. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_LEASE phase=prelaunch lease_token=d7f6a9cb05f33c19ab92ccb78c4a4e8a device=device-1783824528-2609248-26808 session=issue-191 expires_at=1793817291 ts=2026-11-04T18:28:03Z attempt_id=attempt:9cb98254-50cc-47a0-b055-d17971f9a551

  12. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    Dispatching worker (deterministic).

  13. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    DISPATCH_LEASE phase=ready lease_token=d7f6a9cb05f33c19ab92ccb78c4a4e8a device=device-1783824528-2609248-26808 session=issue-191 expires_at=1793824137 ts=2026-11-04T18:28:57Z attempt_id=attempt:9cb98254-50cc-47a0-b055-d17971f9a551


    aidevops.sh v3.39.119 automated scan.

  14. superdav42 commented on Nov 4, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=blocked runner=superdav42 ts=2026-11-04T18:31:07Z aidevops_version=3.39.119 opencode_version=1.18.31 claim_id=6638666775 nonce=d7f6a9cb05f33c19ab92ccb78c4a4e8a lease_token=d7f6a9cb05f33c19ab92ccb78c4a4e8a device=device-1783824528-2609248-26808 session=issue-191

    Terminal blocker: reason=files_scope_excluded owner=brief-author task=191 attempt=549900226a05472732e0119e.
    Projected state: status:blocked.
    Next action: The AI brief owner must review the protected integration dossier, check concurrent ownership and correct the permitted paths before resuming the existing checkpoint. Preserve explicit hard boundaries and security guarantees; do not retry an unchanged brief.
    Raw evidence remains in protected worker telemetry.


    aidevops.sh v3.39.119 plugin for OpenCode v1.18.31

  15. removed their assignment
    on Nov 4, 2026
  16. added
    status:blockedPartial work blocked; inspect reason and next action
    and removed on Nov 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    auto-dispatchconsolidatedIssue superseded by a consolidated childdocumentationImprovements or additions to documentationenhancementNew feature or requesthelp wantedExtra attention is neededorigin:workerCreated by headless/pulse worker sessionstatus:blockedPartial work blocked; inspect reason and next actiontier:standardAuto-created by pulse labelless backfill (t2112)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions