performwp / performwp/perform

Refresh PerformWP site content around 1.6.0 positioning and conversion paths

Open
#187 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area: docs area: frontend enhancement priority: medium status: needs-spec
Dominant language
PHP
Stars
5
Forks
2
PR merge metrics
No merged PRs in 30d

Description

Context

Authority & Growth audit on 2026-07-07 found that the live PerformWP site has a small content inventory and several high-value pages lag behind current product positioning.

Verified sources:

  • PerformWP MCP content inventory: 11 published pages, 3 published posts, 24 published docs.
  • Public sitemap review: homepage refreshed in 2026; posts and docs refreshed selectively in 2025.
  • Current product listing describes newer 1.6.0 capabilities such as redesigned Assets Manager, full-page cache controls, safer cache writes, scanner interface, validation, and current metadata.
  • Public site feature, audit, and docs pages still use older titles, metadata, repeated copy, or sparse content in several places.

Proposed scope

  1. Refresh /features/ to reflect current product capabilities.
  • Replace repeated placeholder descriptions across feature cards.
  • Add current feature clusters: Assets Manager scanner, page cache controls, response validation, stale regeneration and preload scheduling, observability stats, WooCommerce controls, CDN, preconnect, DNS prefetch, and Menu Cache.
  • Add contextual links into the most relevant docs.
  1. Refresh the introductory product post or replace it with a current evergreen overview.
  • Explain what Perform does now, who it is for, and where it fits in a WordPress performance workflow.
  • Include current release positioning without unsupported performance claims.
  • Link to docs, features, GitHub, the product listing, and the audit page.
  1. Rework /web-performance-audit/ as a stronger conversion page.
  • Add who should request an audit, what the report includes, expected inputs, deliverables, proof/trust signals, and the next step.
  • Fix stale internal links where found.
  1. Improve /docs/ as a documentation hub.
  • Replace generic archive metadata and thin archive copy.
  • Surface feature groups and high-intent docs.
  • Add links from feature pages into related docs.
  1. Prepare one new educational comparison or solution draft after the refreshes.
  • Suggested first draft: WordPress Asset Manager vs Cache Plugin: What Each One Optimizes.
  • Keep public copy competitor-neutral and avoid unsupported rankings or Core Web Vitals guarantees.

Acceptance criteria

  • Content changes are prepared as WordPress drafts/previews or repo/site PRs before publish.
  • No public content is published without owner approval.
  • No raw Custom HTML blocks are introduced.
  • Rank Math titles and descriptions are updated for affected pages.
  • Internal links are added between feature, docs, blog, product listing, GitHub, and audit conversion paths where relevant.
  • Screenshots are captured before and after any visible page design changes.
  • Performance claims are conservative and tied to supported product behavior.

Validation

  • Draft/previews open successfully.
  • Block validation passes with registered blocks.
  • Metadata is visible in Rank Math or equivalent SEO tooling.
  • Internal links resolve to live intended URLs.
  • Any design-visible change includes screenshot proof.

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.

Research direction

Start with the PerformWP content inventory, public sitemap, current 1.6.0 product listing, and the existing features, audit, docs, and introductory post pages. Prepare drafts or a site PR covering the proposed refreshes, then validate registered blocks, Rank Math metadata, internal links, previews, and screenshots. Done means owner approval is still required before publication and all listed acceptance criteria pass.

Written by the indexing model from the issue text.

Assessment

Tech stack
php, wordpress
Domain
content, documentation, web-dev
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.