Skip to content

WordPress.org listing: clearer title, description, tags and FAQ - #27

Merged
mostafasoufi merged 1 commit into
mainfrom
listing-seo
Oct 25, 2026
Merged

mostafasoufi merged 1 commit into
mainfrom
listing-seo

Conversation

@mostafasoufi

Copy link
Copy Markdown
Member

Merging this publishes the new readme to WordPress.org right away. The "Readme and assets" workflow runs on every push to main that touches readme.txt. Stable tag 0.1.24 is already released and the readme has no Unreleased section, so the guard passes and the listing text changes within minutes, without a new plugin version.

What changes

Only readme.txt. Version, Stable tag (0.1.24), Tested up to (7.1, current WordPress is 7.1.3) and the changelog are unchanged.

Before After
Name MonoRanks: AI SEO, AEO and GEO Audit with Fixes You Approve MonoRanks – AI SEO Audit, AEO and GEO with One-Click Fixes
Short description AEO (answer engine optimization), GEO and SEO audits plus llms.txt. Fixes are written after you approve them and can be undone. Find what keeps your pages out of Google and AI answers. A weekly AI SEO audit with fixes you approve, written into WordPress, with undo. (137 characters)
Tags seo, aeo, geo, llms-txt, ai-seo seo, ai-seo, seo-audit, aeo, geo

Description:

  • First paragraph says the value in plain words; AEO and GEO are spelled out once.
  • "What you get" leads with one-click fixes and adds category and tag pages.
  • New "How it works" in three steps: install, connect a free account, approve fixes with undo.
  • "Works with your SEO plugin" is now a list that says what is written where (category pages only in Yoast SEO and Rank Math, or the category description with no SEO plugin), matching SeoFields::term_supported().
  • New "Free to start": free account covers 3 websites, paid plans on monoranks.com.
  • The external service and privacy section is unchanged.
  • Installation now starts from the one-button connect on the Overview screen (0.1.22).

FAQ: new questions on price, account, undo, category pages and local or firewalled sites. The disconnect and remove-data answers are merged into one.

Screenshots: captions shortened. No images added or changed.

Why these words

Competitors in the "AI SEO", "AEO" and "GEO" searches (Rank Math, AIOSEO, SEOPress, Slim SEO, Squirrly, GetGenie, Xagio, LovedByAI) all put "AI SEO" in the name. "seo-audit" has 50 plugins in its tag against 236 for "llms-txt", so MonoRanks is easier to find there; llms.txt is still named in the description.

Checks

  • Plugin Check (plugin_readme, plugin_header_fields) run locally on the old and new readme: same single warning as today (readme name differs from the header name "MonoRanks", which is expected for a listing title).
  • The readme is about 17 KB; WordPress.org suggests 10 KB. Moving changelog entries before 0.1.19 to CHANGELOG.md would bring it close. Left as is here.

Screenshots worth retaking (real ones)

The current ones date from September and screenshot 4 shows the old three-step connect screen.

  1. The one-button connect screen (replaces screenshot 4).
  2. The MonoRanks box in the post editor.
  3. "What to do next" on the Overview.
  4. A category page fix in Yoast SEO or Rank Math, before and after.
  5. Recent changes with Undo in Settings.

The plugin name now leads with "AI SEO Audit" and keeps AEO and GEO, the
short description says the benefit first, and the tags swap llms-txt for
seo-audit. The description gains a "How it works" list, a section on
category and tag pages, a per-plugin list of what is written where, and a
note on the free plan. The FAQ now answers the questions people ask before
installing, and the screenshot captions are shorter. Version, Stable tag
and changelog are unchanged.
@mostafasoufi
mostafasoufi merged commit e8cb1be into main Oct 25, 2026
11 checks passed
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.

1 participant