Skip to content

Revise description for improved clarity and structure#295

Merged
metmarkosaric merged 6 commits intoplausible:developfrom
Hricha-Shandily:patch-2
Apr 24, 2026
Merged

Revise description for improved clarity and structure#295
metmarkosaric merged 6 commits intoplausible:developfrom
Hricha-Shandily:patch-2

Conversation

@Hricha-Shandily
Copy link
Copy Markdown
Contributor

@Hricha-Shandily Hricha-Shandily commented Apr 23, 2026

Summary by CodeRabbit

  • Documentation
    • Refreshed plugin documentation to better highlight core capabilities and key use cases.
    • Reorganized feature documentation into clearer, more logical groupings for easier navigation.
    • Expanded screenshot gallery with additional visual examples of dashboard, settings, and integration features.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

📝 Walkthrough

Walkthrough

The readme.txt file is comprehensively rewritten to reposition the plugin as a "Google Analytics alternative" with enhanced marketing messaging. Content is reorganized into new sections covering key value propositions, features are grouped into subsections, and the screenshot gallery is expanded from 2 to 9 items.

Changes

Cohort / File(s) Summary
README Marketing & Documentation Update
readme.txt
Plugin positioning restructured as Google Analytics alternative. Tags and short description expanded with WooCommerce keywords. New sections added: "Why WordPress users choose Plausible," "Shareable and client-friendly dashboards," "Open source and transparent," "Built for WordPress," "Who is this for?," and "Pricing." Features reorganized from flat bullet list into grouped subsections (setup, WordPress tracking with Enhanced Measurements, ecommerce/conversions, reporting). Screenshots gallery expanded from 2 to 9 items with detailed dashboard, settings, goals, revenue, event tracking, and WooCommerce funnel visuals.

Poem

🐰 A readme hops into view,
With dashboards fresh and features new,
No cookies, clean, and perfectly clear—
Plausible shines throughout the year!
Google's got nothing on us, it's true! 🎉

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: a comprehensive revision of the readme.txt file that improves clarity and structure through reorganized sections, expanded messaging, and better feature grouping.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@Hricha-Shandily Hricha-Shandily marked this pull request as ready for review April 24, 2026 06:23
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
readme.txt (1)

26-26: Consider varying sentence structure for better flow.

Three consecutive sentences begin with "We" which creates a slightly monotonous rhythm. Consider rephrasing for variety.

✍️ Suggested rewording
-We're completely independent, self-funded, bootstrapped and debt-free. We're not interested in raising funds or taking investment. We choose the subscription business model rather than surveillance capitalism. We're operating a sustainable project funded solely by the fees that our subscribers pay us.
+We're completely independent, self-funded, bootstrapped and debt-free. We're not interested in raising funds or taking investment. The subscription business model was chosen over surveillance capitalism, and this sustainable project is funded solely by the fees that our subscribers pay us.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@readme.txt` at line 26, The paragraph starting "We're completely independent,
self-funded, bootstrapped and debt-free. We're not interested in raising funds
or taking investment. We choose the subscription business model rather than
surveillance capitalism. We're operating a sustainable project funded solely by
the fees that our subscribers pay us." uses three sentences starting with "We";
rephrase to vary sentence openings and improve flow by combining or
restructuring sentences (e.g., lead with independence, then state funding model
and stance on investment, and finish by explaining sustainability and subscriber
funding) while preserving the original facts and tone.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@readme.txt`:
- Line 61: Change the compound adjective "real time dashboard" to "real-time
dashboard" in the README line that currently reads "Features a real time
dashboard, that's actually real time" so the hyphenated form is used before the
noun while leaving the predicative "actually real time" unchanged.
- Line 111: Update the sentence "Plausible is open source software. You can
inspect and verify the code on GitHub." to use the hyphenated compound adjective
form by changing "open source software" to "open-source software" (so the first
sentence reads "Plausible is open-source software."). Ensure only the
hyphenation is added and no other wording is altered.

---

Nitpick comments:
In `@readme.txt`:
- Line 26: The paragraph starting "We're completely independent, self-funded,
bootstrapped and debt-free. We're not interested in raising funds or taking
investment. We choose the subscription business model rather than surveillance
capitalism. We're operating a sustainable project funded solely by the fees that
our subscribers pay us." uses three sentences starting with "We"; rephrase to
vary sentence openings and improve flow by combining or restructuring sentences
(e.g., lead with independence, then state funding model and stance on
investment, and finish by explaining sustainability and subscriber funding)
while preserving the original facts and tone.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 26611d29-01b6-4d17-94f8-230f2ca4cd4a

📥 Commits

Reviewing files that changed from the base of the PR and between 558eddb and 7b686d6.

⛔ Files ignored due to path filters (9)
  • .wordpress-org/screenshot-1.png is excluded by !**/*.png
  • .wordpress-org/screenshot-2.png is excluded by !**/*.png
  • .wordpress-org/screenshot-3.png is excluded by !**/*.png
  • .wordpress-org/screenshot-4.png is excluded by !**/*.png
  • .wordpress-org/screenshot-5.png is excluded by !**/*.png
  • .wordpress-org/screenshot-6.png is excluded by !**/*.png
  • .wordpress-org/screenshot-7.png is excluded by !**/*.png
  • .wordpress-org/screenshot-8.png is excluded by !**/*.png
  • .wordpress-org/screenshot-9.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • readme.txt

Comment thread readme.txt
- First-party tracking option helps bypass blockers
- No data sampling or estimation
- Count more real visitors compared to traditional analytics tools
- Features a real time dashboard, that's actually real time
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix hyphenation in compound adjective.

"Real time dashboard" should be "real-time dashboard" when used as a compound adjective before the noun. The second instance "actually real time" is correct without a hyphen since it's used predicatively.

✍️ Proposed fix
-- Features a real time dashboard, that's actually real time
+- Features a real-time dashboard, that's actually real time
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- Features a real time dashboard, that's actually real time
- Features a real-time dashboard, that's actually real time
🧰 Tools
🪛 LanguageTool

[grammar] ~61-~61: Use a hyphen to join words.
Context: ...tional analytics tools - Features a real time dashboard, that's actually real tim...

(QB_NEW_EN_HYPHEN)


[grammar] ~61-~61: Use a hyphen to join words.
Context: ...eal time dashboard, that's actually real time Your stats reflect what’s actually...

(QB_NEW_EN_HYPHEN)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@readme.txt` at line 61, Change the compound adjective "real time dashboard"
to "real-time dashboard" in the README line that currently reads "Features a
real time dashboard, that's actually real time" so the hyphenated form is used
before the noun while leaving the predicative "actually real time" unchanged.

Comment thread readme.txt

### Open source and transparent

Plausible is open source software. You can inspect and verify the code on GitHub.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix hyphenation in compound adjective.

"Open source software" should be "open-source software" when used as a compound adjective before the noun.

✍️ Proposed fix
-Plausible is open source software. You can inspect and verify the code on GitHub.
+Plausible is open-source software. You can inspect and verify the code on GitHub.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Plausible is open source software. You can inspect and verify the code on GitHub.
Plausible is open-source software. You can inspect and verify the code on GitHub.
🧰 Tools
🪛 LanguageTool

[grammar] ~111-~111: Use a hyphen to join words.
Context: ...ource and transparent Plausible is open source software. You can inspect and ver...

(QB_NEW_EN_HYPHEN)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@readme.txt` at line 111, Update the sentence "Plausible is open source
software. You can inspect and verify the code on GitHub." to use the hyphenated
compound adjective form by changing "open source software" to "open-source
software" (so the first sentence reads "Plausible is open-source software.").
Ensure only the hyphenation is added and no other wording is altered.

@metmarkosaric metmarkosaric merged commit 78cd864 into plausible:develop Apr 24, 2026
7 checks passed
@Dan0sz
Copy link
Copy Markdown
Collaborator

Dan0sz commented Apr 24, 2026

Hi @Hricha-Shandily,

Can you process the changes proposed by Code Rabbit? It's a couple of typo's. Then we can merge again.

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.

3 participants