Skip to content

Docs: Directory Copy and Demo Gallery Traction Pass - #129

Merged
jasperf merged 10 commits into
mainfrom
docs/directory-traction
Nov 18, 2026
Merged

jasperf merged 10 commits into
mainfrom
docs/directory-traction

Conversation

@jasperf

@jasperf jasperf commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

What this does

Makes the theme easier to evaluate and pick, aimed at the WordPress.org listing and the GitHub front page. Guided by how the directory actually renders:

  • Verified first that theme pages show the style.css Description: header as the Overview text, the screenshot, and an auto-rendered style-variation gallery — there are no FAQ/Screenshots tabs on theme pages anymore. So the WP.org-facing copy work went into style.css, and the visual gallery went into README.md where it actually renders.

Changes

  • screenshot.png — re-shot from elayne/page-home-bold at 1200x900 with the Bold style variation active (the new default homepage look, same as the demo main site). Shot via the toolbox screenshot.sh script; no banners, no promo text, temp page deleted.
  • style.css — Description rewritten: benefit-led, names all verticals, demo link kept, legal child-theme parenthetical dropped from the pitch. Tags now include news and portfolio (both in the official theme-tag list), matched in readme.txt because Theme Check requires the two lists to match.
  • readme.txt — Description lead now links a live demo per vertical (main, kafe, spa, plumbing, nail-salon, store, legal); the legal deprecation move became its own note near the end; six new sales-objection FAQ answers (page builders, existing content, WooCommerce, price, child themes, switching style variations); changelog trimmed to 4.10.0 and newer with a pointer to CHANGELOG.md for older releases (-901 lines); the Copyright section's licence line corrected from GPL v2 to v3, matching every other file; 34 interactive effects corrected to 32 in Key Features to match the CSS Effects breakdown.
  • README.md — new "One Theme, a Site for Every Kind of Business" gallery: seven WebP homepage crops under assets/images/readme/ (main, kafe, spa, nail-salon, plumbing, store, legal), each linking to its live demo; "Why Choose Elayne" rewritten from generic adjectives to checkable claims; pattern count aligned everywhere to 140+ (including 24 WooCommerce).
  • assets/images/readme/ — seven 1440x720 WebP crops (31-64KB each), excluded from the distribution zip via .distignore.

Verification

  • Screenshot: the toolbox script checked the output size (1200x900) and failed on promo text or block errors; the PNG was additionally pixel-compared against the live demo main homepage at the same viewport (mean diff 0.15/255, only the hidden cookie banner differs).
  • Contrast claim: composer check:colors passes ("Colour contract: OK"); the README claim was softened after --report showed the check is informational, not a CI failure.
  • Demo links: all seven public demo URLs (demo.imagewize.com/*) confirmed live; all six subsites checked to contain no cookie-consent markup that would pollute the crops.
  • Theme Check runs in CI on this PR and gates the readme.txt/style.css tag match.

Reviewer notes

  • Found but not fixed here: composer check:colors --report shows spa-wellness primary on page at 2.19:1 (LOW) — the one role pair the 4.12.0 contrast pass did not cover. Suggest a separate branch/division to fix, or a deliberate decision to keep it.
  • The gallery images are development assets behind .distignore; they do not ship in the WP.org zip.
  • Manual check suggestion: open the README on this branch on GitHub, view the gallery at desktop width, and glance at screenshot.png — a review page with all eight images was left open in a Chrome tab locally.

@jasperf
jasperf merged commit fe46b60 into main Nov 18, 2026
3 checks passed
@jasperf
jasperf deleted the docs/directory-traction branch November 18, 2026 04:11
@jasperf jasperf mentioned this pull request Nov 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant