docs: polish wordpress.org readme for marketing and conversion#1202
Conversation
- Trim oversized privacy notice to a concise, compliant disclosure (external services + opt-in analytics) linking the full policy - Rewrite FAQ: drop dead wcpos.com/faq, /docs, /blog links; add buyer-focused Q&As (free vs pro, offline, hardware, card payments, demo, support pointing at docs.wcpos.com + Discord) - Sharpen the short description and Description opening with a clearer positioning hook - Surface payment terminals (Stripe Terminal, SumUp) and popular gateways (Stripe, PayPal, Square, Mollie) in the Pro feature list
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
There was a problem hiding this comment.
kilbot has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.
|
Important Review skippedReview was skipped due to path filters ⛔ Files ignored due to path filters (2)
CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including ⚙️ Run configurationConfiguration used: Repository: wcpos/coderabbit/.coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
📝 WalkthroughWalkthroughThe readme.txt content was updated with revised product description text, adjusted PRO payment feature bullets, and a larger FAQ plus rewritten Privacy section covering translation loading, analytics consent, and Pro license activation. ChangesReadme copy updates
Estimated code review effort: 1 (Trivial) | ~5 minutes Related PRs: None referenced. Suggested labels: documentation Suggested reviewers: None identified from the provided information. Would you like the privacy wording checked against the implementation details for translation loading, analytics consent, and license activation? Poem A readme’s words were freshened here, 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: a056b95b9d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
Review-fix triage before changes:
|
There was a problem hiding this comment.
kilbot has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.
|
Post-fix triage table:
Skipped threads: none. Remaining unresolved inline review threads after re-query: 0. |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 2
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@readme.txt`:
- Around line 10-14: The README wording in the WCPOS description overstates
offline capability; update the copy in the main description to match the
documented behavior. Specifically, adjust the “keep selling even when the
internet drops” claim so it only promises offline browsing/cart building unless
full offline checkout is actually supported, and keep the phrasing aligned with
the FAQ and WCPOS positioning.
- Around line 121-127: Update the privacy copy in the section describing WCPOS
data flows so it matches the actual transfers listed above: replace the broad
“No data is ever sold or shared” claim with a narrower statement that references
transfers to third-party/service providers such as jsDelivr and wcpos.com. Keep
the wording aligned with the existing bullets in the readme text and ensure the
change reflects the translation, analytics, and license activation disclosures
already described.
🪄 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: Repository: wcpos/coderabbit/.coderabbit.yaml
Review profile: CHILL
Plan: Pro Plus
Run ID: ecbec569-ca94-428f-b092-be98f0ee071d
📒 Files selected for processing (1)
readme.txt
|
Review-fix triage before changes:
|
There was a problem hiding this comment.
kilbot has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.
|
Post-fix triage table:
Skipped threads: none. Remaining unresolved inline review threads after re-query: 0. |
|
Post-fix triage table:
Skipped threads: none. Remaining unresolved inline review threads after fresh GraphQL re-query: 0. |
Replace the old low-res storefront banner with a bright top-down counter shot showing the WCPOS POS in use (tablet, thermal printer, card terminal, scanner). Adds the WCPOS logo mark, a red 'Point of Sale for WooCommerce' eyebrow and the Geist headline over a soft top wash, matching the wcpos.com hero. Both the 772x250 standard and 1544x500 retina sizes.
There was a problem hiding this comment.
kilbot has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.
1 participant
Summary
Marketing/conversion polish of the wordpress.org listing (
readme.txt). No runtime code changes.wcpos.com/faq→ now 301s to docs,wcpos.com/docs, and the non-existent/blog). Replaced with buyer-focused Q&As that double as conversion copy: is it really free, offline, what hardware, can I take card payments, free vs Pro, live demo, and where to get help (docs.wcpos.com + Discord).Design decisions (preserve through rebases)
$129/yror5,000+ storesback in.Follow-ups (not in this PR)
Tested up to: 7.0in the header looks wrong (WordPress 7.0 doesn't exist yet) — left unchanged pending confirmation of the actual tested version.1. WCPOS main screen). Adding 4–6 (POS grid, cart/checkout, receipt gallery, printer setup, mobile) is likely the single biggest wordpress.org conversion lever, but requires image assets — out of scope here.Test plan
readme.txtthrough the wordpress.org readme validator / preview and confirm no formatting breakage.🤖 Generated with Claude Code
Summary by CodeRabbit