Skip to content

Update Rocket docs for current MainWP navigation and actions - #66

Merged
bkatusic merged 1 commit into
mainfrom
docs-review/rocket-extension
May 29, 2026
Merged

bkatusic merged 1 commit into
mainfrom
docs-review/rocket-extension

Conversation

@bkatusic

@bkatusic bkatusic commented May 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Updated the WP Rocket add-on page to match the installed mainwp-rocket-extension 5.1.7 behavior.
  • Corrected the add-on link and metadata, current Add-ons > Performance > Rocket navigation, settings tab names, and the cache action labels.
  • Aligned the install and site-specific settings steps with the current MainWP Dashboard and Child code.

Testing

  • Not run (not requested)
  • Performed static verification against the installed MainWP Dashboard, MainWP Child, and Rocket extension source plus nav-breakdown.md.

Summary by CodeRabbit

  • Documentation
    • Updated Rocket add-on documentation to reflect version 5.1.7 with current integration details
    • Revised installation and configuration instructions to match current navigation workflows
    • Updated cache management instructions to reflect current Quick Actions interface
    • Improved clarity on activation and settings management processes

Review Change Stack

@coderabbitai

coderabbitai Bot commented May 29, 2026

Copy link
Copy Markdown

Walkthrough

The Rocket add-on documentation is refreshed with updated integration metadata, version 5.1.7, and revised feature descriptions. Installation, settings management, and cache action workflows are rewritten to align with current MainWP navigation paths, UI labels, and step sequences.

Changes

Rocket Add-on Documentation Refresh

Layer / File(s) Summary
Overview and integration metadata
add-ons/performance/rocket-extension.mdx
Opening description rephrased with "clear and preload cache" wording; integration content and WP Rocket feature bullet list updated with current descriptors and capability order.
Installation workflow steps
add-ons/performance/rocket-extension.mdx
Installation step titles updated to reflect new MainWP navigation paths; "Activate after installation" requirement explicitly stated; child-site plugin installation path clarified.
Settings management and updates
add-ons/performance/rocket-extension.mdx
"WP Rocket Dashboard" and "Manage WP Rocket Settings" sections rewritten with updated navigation routes; category list adjusted; "Update settings on all sites" and "Update settings on a single site" workflows revised with new MainWP labels and override-general-settings instructions.
Cache clearing and preload actions
add-ons/performance/rocket-extension.mdx
"Clear/Preload WP Rocket Cache" section rewritten to describe current Quick Actions buttons: Clear/Preload Cache, Regenerate Critical CSS, and Clear Priority Elements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • mainwp/docs#22: Documentation-only MDX updates adjusting add-on metadata and MainWP navigation paths in installation/configuration sections.
  • mainwp/docs#31: MDX add-on documentation updates matching current MainWP UI/navigation paths and step/button labels.
  • mainwp/docs#63: Documentation-only MDX updates for performance add-ons revising integration metadata and MainWP navigation routes.
🚥 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 reflects the main change: updating Rocket documentation to reflect current MainWP navigation paths and action labels in the UI.
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
  • Commit unit tests in branch docs-review/rocket-extension

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
add-ons/performance/rocket-extension.mdx (2)

195-199: 💤 Low value

Consider varying sentence structure.

Three consecutive bullet points begin with "By clicking the", which creates a monotonous reading experience. Consider restructuring for better flow.

✍️ Suggested revision
 MainWP Rocket Extension allows you to quickly clear and preload cache on your child sites. On the **MainWP > Add-ons > Performance > Rocket** page, under the **Quick Actions** tab, you will find the **Clear and Preload Cache**, **Regenerate Critical CSS**, and **Clear Priority Elements** buttons.
 
--   By clicking the **Clear and Preload Cache** button, you will clear and preload cache on all child sites where WP Rocket is installed.
--   By clicking the **Regenerate Critical CSS** button, you will trigger WP Rocket critical CSS generation on those child sites.
--   By clicking the **Clear Priority Elements** button, you will clear WP Rocket priority elements on those child sites.
+-   **Clear and Preload Cache** - Clears and preloads cache on all child sites where WP Rocket is installed.
+-   **Regenerate Critical CSS** - Triggers WP Rocket critical CSS generation on those child sites.
+-   **Clear Priority Elements** - Clears WP Rocket priority elements on those child sites.

As per coding guidelines: "style suggestion from LanguageTool - Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym."

🤖 Prompt for 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.

In `@add-ons/performance/rocket-extension.mdx` around lines 195 - 199, The three
bullet lines under the "Quick Actions" tab on the MainWP Rocket page ("Clear and
Preload Cache", "Regenerate Critical CSS", "Clear Priority Elements") all start
with "By clicking the", producing monotonous flow; rephrase each bullet so
sentence openings vary (e.g., start one with the action: "Clears and preloads
cache on all child sites...", another with the effect: "Triggers WP Rocket
critical CSS generation...", and another with the result: "Removes WP Rocket
priority elements from child sites...") while keeping the same button labels and
meaning.

59-59: 💤 Low value

Consider replacing weak intensifier.

The phrase "very simple" could be strengthened. Consider alternatives like "straightforward", "easy", or simply "simple".

✍️ Suggested revision
-WP Rocket integrates performance features such as deferred JavaScript loading, delayed JavaScript execution, LazyLoad, CSS delivery optimization, minification, CDN configuration, and cache preloading. While being complete, WP Rocket is also very simple to configure, even for beginners. WP Rocket also has its own self-hosted crawler bot that will visit your site and generate cached files so that when human visitors come to your website, they immediately get the fast, cached version of the page. If you have issues with the WP Rocket plugin, help documentation can be found in the [WP Rocket documentation](https://docs.wp-rocket.me/).
+WP Rocket integrates performance features such as deferred JavaScript loading, delayed JavaScript execution, LazyLoad, CSS delivery optimization, minification, CDN configuration, and cache preloading. While being complete, WP Rocket is also straightforward to configure, even for beginners. WP Rocket also has its own self-hosted crawler bot that will visit your site and generate cached files so that when human visitors come to your website, they immediately get the fast, cached version of the page. If you have issues with the WP Rocket plugin, help documentation can be found in the [WP Rocket documentation](https://docs.wp-rocket.me/).

As per coding guidelines: "style suggestion from LanguageTool - As an alternative to the over-used intensifier 'very', consider replacing this phrase."

🤖 Prompt for 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.

In `@add-ons/performance/rocket-extension.mdx` at line 59, Replace the weak
intensifier in the sentence containing "very simple to configure" in
rocket-extension.mdx: change "very simple to configure" to a stronger phrasing
such as "straightforward to configure", "easy to configure", or simply "simple
to configure" so the copy reads more concise and authoritative while preserving
meaning.
🤖 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.

Nitpick comments:
In `@add-ons/performance/rocket-extension.mdx`:
- Around line 195-199: The three bullet lines under the "Quick Actions" tab on
the MainWP Rocket page ("Clear and Preload Cache", "Regenerate Critical CSS",
"Clear Priority Elements") all start with "By clicking the", producing
monotonous flow; rephrase each bullet so sentence openings vary (e.g., start one
with the action: "Clears and preloads cache on all child sites...", another with
the effect: "Triggers WP Rocket critical CSS generation...", and another with
the result: "Removes WP Rocket priority elements from child sites...") while
keeping the same button labels and meaning.
- Line 59: Replace the weak intensifier in the sentence containing "very simple
to configure" in rocket-extension.mdx: change "very simple to configure" to a
stronger phrasing such as "straightforward to configure", "easy to configure",
or simply "simple to configure" so the copy reads more concise and authoritative
while preserving meaning.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0997a868-97e6-4946-a6e5-bc81fd2fe6e8

📥 Commits

Reviewing files that changed from the base of the PR and between a0da36c and f35200f.

📒 Files selected for processing (1)
  • add-ons/performance/rocket-extension.mdx

@mintlify

mintlify Bot commented May 29, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mainwp 🟢 Ready View Preview May 29, 2026, 5:09 PM

@bkatusic
bkatusic merged commit 1c25dd7 into main May 29, 2026
5 checks passed
@bkatusic
bkatusic deleted the docs-review/rocket-extension branch May 29, 2026 17:14
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