Skip to content

docs: align README with Aviendha/Aludra family branding - #106

Merged
jasperf merged 8 commits into
mainfrom
docs/readme-family-branding
Aug 22, 2026
Merged

docs: align README with Aviendha/Aludra family branding#106
jasperf merged 8 commits into
mainfrom
docs/readme-family-branding

Conversation

@jasperf

@jasperf jasperf commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Brings README.md in line with the badge/logo/lineage conventions already used by Aviendha and Aludra's READMEs, then fixes several license/description/count inaccuracies discovered along the way. Bumped to 4.9.1 (patch, docs-only).

README branding

  • Swap the old banner image for a centered logo + badge row above the title
  • Add a Lineage note cross-linking Aviendha, Nynaeve, Ixian, and the shared Aludra plugin dependency
  • List WooCommerce and Aludra as optional/recommended directly in the Requirements list
  • Add a License section pointing to LICENSE.md (GPL v3, confirmed against the actual file)
  • Remove assets/images/readme-banner.jpg, now unreferenced

License & description fixes

  • composer.json's and package.json's license fields still said GPL-2.0-or-later — missed when style.css/readme.txt/LICENSE.md were migrated to GPL v3. composer.json's is what Packagist reads for the README's shields.io License badge.
  • composer.json's description was the placeholder "A WordPress block theme by Jasper Frumau" — replaced with the theme's actual GitHub repo description.
  • package.json's version was stale at 4.9.0; its keywords array had lowercase "wordpress", which trips the Theme Check GitHub Action's required WordPress_Spelling_Check rule — this is what was failing CI.

Pattern/template count corrections

Verified against the actual files: 119 non-WooCommerce + 24 WooCommerce patterns (143 total) in patterns/, 19 files in templates/.

  • README.md's "125+ patterns" (quoted apart from "24 WooCommerce patterns") overclaimed the real 119 non-WooCommerce count → "115+"
  • readme.txt's "125+" mentions undersold the real combined total → "140+"
  • readme.txt's "17 page and post templates" undercounted (real: 19) and omitted WooCommerce templates
  • CONTRIBUTING.md's and readme.txt's detailed per-category breakdown were both stale — recounted from each pattern's Categories: header. Notable moves: Pages 11→16, Spa & Wellness 10→14, Food & Beverage 14→17; Statistics/Team dropped from Core (every remaining tagged pattern is vertical-specific now)

Page patterns messaging

Surfaced the 8 ready-to-insert page patterns (full-page compositions: Homepage, About, Contact, Services, plus Store variants) as a named capability in style.css's Description, composer.json's/package.json's description, README.md's Page Layouts bullet, and readme.txt — previously only implicit in the pattern count. README.md's bullet also now lists all 8 instead of the original 4 (it omitted the Store-specific compositions).

- Swap banner image for centered logo + badge row above the title
- Add Lineage note cross-linking Aviendha, Nynaeve, Ixian, and Aludra
- List WooCommerce and Aludra as optional/recommended in Requirements
- Add a License section pointing to LICENSE.md (GPL v3)
- Remove now-orphaned assets/images/readme-banner.jpg
Documents the README family-branding changes in CHANGELOG.md and
readme.txt, and bumps style.css to match.
Packagist reads this field for the README's shields.io License badge.
style.css, readme.txt, and LICENSE.md were already migrated to GPL v3;
composer.json was missed at the time.
Use the same description already published on the GitHub repo instead
of the generic 'A WordPress block theme by Jasper Frumau' placeholder.
Verified against actual file counts: 119 non-WooCommerce + 24
WooCommerce patterns (143 total) in patterns/, 19 files in templates/.

- README.md's '125+ patterns' (quoted apart from '24 WooCommerce
  patterns') overclaimed the real 119 non-WooCommerce count -> 115+
- readme.txt's three '125+' mentions quote a combined total and
  undersold the real 143 -> 140+
- readme.txt's '17 page and post templates' undercounted the real 19
  and omitted WooCommerce templates -> matches README.md's wording
…s everywhere

Recounted every pattern's Categories: header (vertical tag takes
priority over a generic one) to replace the stale per-category
breakdown in CONTRIBUTING.md and readme.txt's Pattern Collection
section. New verified totals (143 patterns): Core 40, Specialized 25
(Pages 16, up from a stale 11), Industry Verticals 54 (Spa 14 and
Food & Beverage 17, both up from stale figures; Legal/Home
Improvement/Nail Salon were already accurate), WooCommerce 24.
Statistics and Team dropped from Core Patterns — every pattern still
tagged with those categories is vertical-specific now.

Also surfaces the ready-to-insert page patterns (full-page
compositions like Homepage, About, Contact, Services, and the Store
variants) as a named capability in style.css's Description,
composer.json's description, README.md's Page Layouts bullet, and
readme.txt's intro/Key Features/Pattern Collection — previously only
implicit in the overall pattern count. README.md's bullet also now
lists all 8 page patterns instead of the original 4, which omitted
the Store-specific compositions.
keywords had lowercase 'wordpress', tripping the required rule ->
'WordPress'. Also caught while in there: version was stale at 4.9.0
and license still GPL-2.0-or-later (same issue already fixed in
composer.json); both corrected, and description's pattern count
refreshed to match.
CHANGELOG.md and readme.txt both described the package.json bug by
quoting the lowercase string verbatim, which trips the same
WordPress_Spelling_Check rule the previous commit was fixing.
Rephrased to describe the bug without spelling it out.
@jasperf
jasperf merged commit 3bb7fde into main Aug 22, 2026
3 checks passed
@jasperf
jasperf deleted the docs/readme-family-branding branch August 22, 2026 09:11
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