Skip to content

docs: refresh the README - #15

Merged
ogorzalka merged 4 commits into
mainfrom
docs/readme-refresh
Oct 7, 2026
Merged

ogorzalka merged 4 commits into
mainfrom
docs/readme-refresh

Conversation

@ogorzalka

@ogorzalka ogorzalka commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

Two READMEs. .github/README.md is the GitHub showcase (GitHub shows it before the root one). The scaffolder copies with File::allFiles(), which skips dot-directories (checked), so it never reaches users. The root README.md is the generated project's own guide: placeholders that make:theme/make:plugin fill in (checked against bin/replacements.php: no placeholder left), what's inside, the commands, links to pollora.dev. No banner, no org footer.

Packaging. The rsync now leaves /README.md, /.github/, /LICENSE and /license.txt alone. Before this, --delete would have removed .github/ and its workflows, because the dev copies have none. The package.json license is set back after the sync, and the sed loop and leak check skip .github/.

Showcase: banner, badges, screenshot. Installation via --repository=Pollora/theme-apiary or "E-commerce". Requirements fixed: PHP 8.4+ / WordPress 7.1+ for a new project; WooCommerce 10.3+ (the newest template override @version; CI runs the latest release); Node 20.19+/22.12+. They used to say PHP 8.1 / WP 6.0 / WC 8.0 / Node 18. Counts fixed (130 views, 12 menu locations); structure and config table completed.

License: LICENSE holds the unmodified GPL-2.0 text and replaces license.txt, a Themosis leftover. package.json declares GPL-2.0-or-later, set back after each packaging run.

Also: the sed loop now skips bin/. Packaging was rewriting the theme's own CI specs (bin/tests/e2e/editor.spec.ts, sweep.php: apiary/ci-dynamic became %theme_name%/ci-dynamic).

Checked: php bin/tests/design-system.php passes. A packaging run from the local apiary copy succeeds and leaves README, .github, LICENSE and bin untouched. No tag.

license.txt was a leftover from Themosis (its own name and copyright in the
appendix). LICENSE now holds the unmodified GPL-2.0 text from gnu.org, the
package script leaves both names alone, and package.json declares the same
SPDX id as style.css.
…cts their own README

GitHub shows .github/README.md before the root one, and the scaffolder's
File::allFiles() skips dot-directories, so the showcase stays on GitHub and
the root README, with placeholders, becomes the generated project's guide.
The rsync now leaves README.md, .github/ and the license files alone (with
--delete it removed .github/ and its workflows), the sed loop and leak check
skip .github/ and bin/ (they rewrote the template's own tests), and the
package.json license is set back after the sync.
@ogorzalka
ogorzalka merged commit df2e223 into main Oct 7, 2026
3 checks passed
@ogorzalka
ogorzalka deleted the docs/readme-refresh branch October 7, 2026 08:38
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