performwp / performwp/perform

Add TESTING.md for local, CI, and release-branch validation rules

Open
#174 0 comments 0 reactions 1 assignee View on GitHub

@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.md with 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.