Skip to content

docs(php-packages): add README headers and point contributions at wp-tooling - #74

Merged
AnuragVasanwala merged 1 commit into
mainfrom
docs/php-package-readmes
Oct 1, 2026
Merged

AnuragVasanwala merged 1 commit into
mainfrom
docs/php-package-readmes

Conversation

@aryanjasala

Copy link
Copy Markdown
Member

The rtCamp/wp-phpcs and rtCamp/wp-phpstan READMEs are split from composer-packages/*/README.md, and they double as the Packagist pages. This gives both:

  • the same header as wp-primitives: a centred title, license / PHP / tool-version badges, and a one-line summary
  • a note that the mirror repository is read-only, so issues and pull requests come here instead of the mirror
  • an [Unreleased] CHANGELOG entry per package

Why the mirrors look older than this

The mirrors still show the v1.0.0 split from 2026-07-29. The License section with the rtCamp banner and the LICENSE files were added here on 2026-07-30 (8235ccb), and no v* tag has been cut since. They reach the mirrors with the next release:

  1. merge Go-live fixes: CI, release, security and scaffold installs #72 (it adds the resync_branch repair for the bot commit on both mirrors)
  2. run release-php.yml with resync_branch=true
  3. tag v1.1.0

That release also carries this PR and the Packagist metadata from #72, ahead of the Packagist submission.

…tooling

The wp-phpcs and wp-phpstan READMEs are also the mirror repositories' and Packagist's front pages. Each now opens with the same header as wp-primitives (license, PHP and tool-version badges, a one-line summary) and says the mirror is read-only, so issues and pull requests come to this repository.
Copilot AI balanced review requested due to automatic review settings October 1, 2026 17:12

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The documentation is accurate, consistent with package constraints, and uses valid repository links.

Review effort: Balanced
Findings: None

What changed in this PR

Adds consistent package headers and clarifies that development occurs in the wp-tooling monorepo.

Changes:

  • Adds centered titles, metadata badges, and summaries.
  • Directs contributions away from read-only mirrors.
  • Records these updates under [Unreleased].
File Description
composer-packages/​phpcs/​README.md Adds PHPCS package header and contribution notice.
composer-packages/​phpcs/​CHANGELOG.md Records the README update.
composer-packages/​phpstan/​README.md Adds PHPStan package header and contribution notice.
composer-packages/​phpstan/​CHANGELOG.md Records the README update.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@AnuragVasanwala
AnuragVasanwala requested review from AnuragVasanwala and removed request for AnuragVasanwala October 1, 2026 17:15
@AnuragVasanwala
AnuragVasanwala merged commit 7b951b5 into main Oct 1, 2026
5 checks passed
@AnuragVasanwala
AnuragVasanwala deleted the docs/php-package-readmes branch October 1, 2026 17:15
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.

3 participants