Skip to content

docs: rewrite wp.org plugin page, leaner copy, video embed, screenshots - #317

Merged
epeicher merged 1 commit into
trunkfrom
update/wporg-plugin-page
Jul 6, 2026
Merged

docs: rewrite wp.org plugin page, leaner copy, video embed, screenshots#317
epeicher merged 1 commit into
trunkfrom
update/wporg-plugin-page

Conversation

@AllTerrainDeveloper

@AllTerrainDeveloper AllTerrainDeveloper commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

What

Rewrites the WordPress.org plugin page (readme.txt) to be more compelling: fewer words, more demonstrative visuals, better directory SEO.

Changes

readme.txt

  • Description cut from a 12-bullet feature dump to four short benefit-led sections: A real desktop, Make it yours, Superpowers, Built to be extended.
  • YouTube teaser (https://www.youtube.com/watch?v=jii_gGbqUx4) embedded at the top of the description. wp.org auto-embeds YouTube URLs on their own line; direct video uploads to the SVN assets dir are not supported, so the link is the only option.
  • Short description and tags tuned for plugin-directory search (uidashboard).
  • "AI Copilot" renamed to "AI Assistant" throughout the page body to match the UI (changelog entries left as-is).
  • External services disclosure, Installation, FAQ, and Changelog otherwise untouched.

Screenshots — seven added to .wordpress-org/, deployed to the SVN assets dir by the 10up action on the next release tag:

  1. Multitasking hero — four admin windows side by side
  2. Custom wallpaper + plugin widgets
  3. AI Assistant (Cmd+K)
  4. Content Graph
  5. OS Settings wallpaper picker
  6. Files on the desktop
  7. Recycle Bin

Notes

  • Content-only change; npm run build ran clean with no asset diffs.
  • The new page goes live on wp.org with the next release (or a manual SVN commit if wanted sooner).
Open WordPress Playground Preview

…shots

- Tighter, benefit-led description (~40% fewer words) with the YouTube
  teaser embedded at the top (wp.org auto-embeds YouTube URLs; video
  files can't be uploaded to the SVN assets dir)
- Seven screenshots in .wordpress-org/ (deployed by the 10up action on
  the next release) with SEO-friendly captions
- Short description and tags tuned for plugin-directory search
- Consistent "AI Assistant" naming to match the UI (changelog untouched)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@AllTerrainDeveloper AllTerrainDeveloper changed the title docs: rewrite wp.org plugin page — leaner copy, video embed, screenshots docs: rewrite wp.org plugin page, leaner copy, video embed, screenshots Jul 6, 2026
@AllTerrainDeveloper

Copy link
Copy Markdown
Collaborator Author
image image image

@epeicher
epeicher merged commit 9c2f467 into trunk Jul 6, 2026
5 checks passed
@epeicher
epeicher deleted the update/wporg-plugin-page branch July 6, 2026 16:43
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.

2 participants