Add TESTING.md for local, CI, and release-branch validation rules
Open
@mehul0810 is already working on this.
Since Jul 7, 2026.
area: build-ci
area: docs
priority: medium
status: ready
type: maintenance
- Dominant language
- PHP
- Stars
- 5
- Forks
- 2
- PR merge metrics
- No merged PRs in 30d
Description
Summary
The repo does not have a dedicated TESTING.md that explains how Perform validation should be run and reported across local, CI, and release-branch work.
Evidence
- Repo-root audit found no
TESTING.md. - Validation commands exist in
README.md, but there is no durable testing/proof guide for product PO and worker behavior. - Current blocker work already depends on distinguishing local CLI proof, CI proof, and blocked browser screenshot paths.
Scope
- Add
TESTING.mdwith the canonical validation matrix for PHP, JS/CSS, build, packaging, and browser checks. - Cover local contributor workflows, CI expectations, and release-branch validation.
- Explain when
wp-env, Studio,studio wp, and GitHub Actions artifacts are the right proof source. - Require explicit documentation of any unrun validation step or blocked proof path.
Acceptance criteria
- One canonical testing doc exists in the repo root.
- Validation commands in the doc match current repo tooling.
- The doc explains proof-source hierarchy for local, CI, and screenshot/browser checks.
- Proof gaps and blocked environments must be recorded explicitly instead of implied.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.