Skip to content

auto-recover: orphaned worker branch for #48#52

Merged
superdav42 merged 1 commit into
mainfrom
feature/auto-20260512-005746-gh48
May 13, 2026
Merged

auto-recover: orphaned worker branch for #48#52
superdav42 merged 1 commit into
mainfrom
feature/auto-20260512-005746-gh48

Conversation

@superdav42
Copy link
Copy Markdown
Contributor

@superdav42 superdav42 commented May 13, 2026

Orphan recovery PR — worker pushed this branch but exited before opening a PR.

Branch feature/auto-20260512-005746-gh48 was pushed by headless worker session issue-48 which released as worker_branch_orphan. This PR was auto-created by the orphan-recovery path (GH#20819) so the change can land via the normal review and merge pipeline.

Resolves #48

Summary by CodeRabbit

  • New Features

    • Site exports now include a self-booting index.php for standalone installation on fresh hosts without separate plugin setup
    • Network export capability to archive all subsites in a single ZIP file
    • Checkout form editor warns when required fields are missing for added products
  • Documentation

    • Added comprehensive Site Export administration guide
    • Expanded Import/Export settings documentation with direct link to Site Export tool
    • Updated Site Templates toggle behavior documentation

Review Change Stack

@superdav42 superdav42 added the origin:worker-takeover Worker took over from interactive session label May 13, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 13, 2026

📝 Walkthrough

Walkthrough

This PR documents four features from Ultimate Multisite v2.11.0 (released 2026-05-11): site and network export workflows with self-booting ZIP installation, site template selection enforcement via fallback chain, checkout form editor warnings for incomplete pricing tables, and updated Import/Export settings scope.

Changes

Ultimate Multisite v2.11.0 Documentation

Layer / File(s) Summary
Site Export Admin Page & Navigation
docs/user-guide/administration/site-export.md, sidebars.js
New Site Export user guide documents exporting single sites and networks, describes self-booting index.php and readme.txt bundled in ZIP archives, and provides step-by-step restoration instructions for fresh hosts. Sidebar navigation updated to surface the new admin page.
Site Exporter Addon Documentation & Changelog
docs/addons/site-exporter/changelog.md, docs/addons/site-exporter/index.mdx, docs/user-guide/administration/settings-reference.md
Site Exporter v1.0.6 changelog entry and expanded export workflow documentation in addon index. Settings reference adds Import/Export subsection linking to Site Export tool for archive generation.
Site Templates Enforcement Documentation
docs/user-guide/configuration/creating-your-first-subscription-product.md
Updated Site Templates tab section explains that Allow Site Templates toggle disabled state enforces fallback chain: plan settings first, then checkout-form settings, then pre-selected/URL-provided templates block customer selection across all entry points.
Checkout Form Editor Warnings
docs/user-guide/configuration/checkout-forms.md
Documents new pricing table field editor warning triggered when products are added before required checkout fields exist, prompting users to complete field setup before publishing live registration forms.
Release Notes v2.11.0
docs/user-guide/getting-started/release-notes.md
Adds Version 2.11.0 release entry synthesizing five bullet points: site export ZIP self-booting installation, network export single-archive capability, site templates fallback chain enforcement, checkout form editor warnings, and expanded Import/Export settings scope with direct tool link.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Suggested labels

origin:worker

🐰 A bundle of docs takes flight,
Self-booting zips and exports bright,
Templates cascade, warnings show,
Release two-eleven steals the show!
*~ CodeRabbit*

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The PR title 'auto-recover: orphaned worker branch for #48' is vague and does not clearly communicate the actual documentation changes being made; it refers to the recovery mechanism rather than the content updates. Consider a more descriptive title that summarizes the actual changes, such as 'Docs: Add v2.11.0 documentation for site export, templates enforcement, and checkout warnings' to better communicate the PR's purpose to reviewers.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed All three coding documentation requirements from issue #48 are met: site export pages document self-booting ZIPs and network export [docs/user-guide/administration/site-export.md], Allow Site Templates enforcement is documented [docs/user-guide/configuration/creating-your-first-subscription-product.md], checkout form warnings are documented [docs/user-guide/configuration/checkout-forms.md], and changelog entries are added [release-notes.md, site-exporter/changelog.md].
Out of Scope Changes check ✅ Passed All changes are scoped to documentation updates required by issue #48; the addition of site-export to sidebars.js and the Import/Export settings reference are both directly supporting the issue requirements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/auto-20260512-005746-gh48

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.

Copy link
Copy Markdown

@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: 1

🧹 Nitpick comments (2)
docs/user-guide/getting-started/release-notes.md (2)

14-14: ⚡ Quick win

Use "Improved:" prefix for accuracy and consistency.

This item describes an enhancement to an existing Import/Export settings tab (clearer scope description and added link), not a new feature. The PR objectives categorize this as a "clarification." Following the established pattern in other release notes (e.g., line 34), enhancements to existing features use the "Improved:" prefix.

♻️ Suggested revision for consistency
-- New: Import/Export settings tab now clearly describes its scope and links directly to the Site Export tool.
+- Improved: Import/Export settings tab now clearly describes its scope and links directly to the Site Export tool.
🤖 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 `@docs/user-guide/getting-started/release-notes.md` at line 14, Change the
release note entry that currently starts with "New: Import/Export settings tab
now clearly describes its scope and links directly to the Site Export tool." to
use the "Improved:" prefix (i.e., replace "New:" with "Improved:") so it
correctly categorizes this enhancement as a clarification rather than a new
feature.

10-10: 💤 Low value

Consider mentioning both bundled files for completeness.

The PR objectives indicate the self-booting export ZIP includes both index.php and readme.txt. Consider mentioning both files to fully describe what users receive in the export bundle.

📝 Suggested revision
-- New: Site exports now bundle a self-booting `index.php` so the ZIP can be installed on a fresh host without a separate plugin install.
+- New: Site exports now bundle a self-booting `index.php` and `readme.txt` so the ZIP can be installed on a fresh host without a separate plugin install.
🤖 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 `@docs/user-guide/getting-started/release-notes.md` at line 10, Update the
release note sentence that currently mentions only `index.php` so it lists both
bundled files—`index.php` and `readme.txt`—making clear the self-booting export
ZIP includes both files; locate the line referencing `index.php` and amend the
wording to reference both `index.php` and `readme.txt` together in the same
sentence.
🤖 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 `@docs/user-guide/administration/site-export.md`:
- Around line 1-4: The frontmatter in this doc uses a duplicate sidebar_position
(11) which conflicts with settings-reference.md; update the YAML frontmatter for
this page (the sidebar_position key in site-export.md) to a unique integer
(e.g., change to 9 or increment this and subsequent pages) and ensure you also
update settings-reference.md and any following pages so all sidebar_position
values are unique and remain correct relative to the Administration sidebar
ordering.

---

Nitpick comments:
In `@docs/user-guide/getting-started/release-notes.md`:
- Line 14: Change the release note entry that currently starts with "New:
Import/Export settings tab now clearly describes its scope and links directly to
the Site Export tool." to use the "Improved:" prefix (i.e., replace "New:" with
"Improved:") so it correctly categorizes this enhancement as a clarification
rather than a new feature.
- Line 10: Update the release note sentence that currently mentions only
`index.php` so it lists both bundled files—`index.php` and `readme.txt`—making
clear the self-booting export ZIP includes both files; locate the line
referencing `index.php` and amend the wording to reference both `index.php` and
`readme.txt` together in the same sentence.
🪄 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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3afe99e7-c7bd-4d8d-be4d-9f21f9f1a440

📥 Commits

Reviewing files that changed from the base of the PR and between 1d34d9c and d16804f.

📒 Files selected for processing (8)
  • docs/addons/site-exporter/changelog.md
  • docs/addons/site-exporter/index.mdx
  • docs/user-guide/administration/settings-reference.md
  • docs/user-guide/administration/site-export.md
  • docs/user-guide/configuration/checkout-forms.md
  • docs/user-guide/configuration/creating-your-first-subscription-product.md
  • docs/user-guide/getting-started/release-notes.md
  • sidebars.js

Comment on lines +1 to +4
---
title: "Site Export"
sidebar_position: 11
---
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Duplicate sidebar_position value causes ambiguity.

Both this file and settings-reference.md use sidebar_position: 11. While the Administration category currently uses an explicit items array in sidebars.js (so array order takes precedence), duplicate positions create maintenance risk if the sidebar structure changes to autogenerated or if positions are used for sorting elsewhere.

📝 Suggested fix

Assign a unique position. Since this page appears between managing-system-emails and plugin-builder-and-sandbox in the sidebar array, consider using position 9 or incrementing subsequent positions:

 ---
 title: "Site Export"
-sidebar_position: 11
+sidebar_position: 9
 ---

And update settings-reference.md and any subsequent pages to maintain uniqueness.

📝 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
---
title: "Site Export"
sidebar_position: 11
---
---
title: "Site Export"
sidebar_position: 9
---
🤖 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 `@docs/user-guide/administration/site-export.md` around lines 1 - 4, The
frontmatter in this doc uses a duplicate sidebar_position (11) which conflicts
with settings-reference.md; update the YAML frontmatter for this page (the
sidebar_position key in site-export.md) to a unique integer (e.g., change to 9
or increment this and subsequent pages) and ensure you also update
settings-reference.md and any following pages so all sidebar_position values are
unique and remain correct relative to the Administration sidebar ordering.

@superdav42 superdav42 merged commit ec0cce6 into main May 13, 2026
1 check passed
@superdav42
Copy link
Copy Markdown
Contributor Author

Orphan recovery PR — worker pushed this branch but exited before opening a PR.
Branch feature/auto-20260512-005746-gh48 was pushed by headless worker session issue-48 which released as worker_branch_orphan. This PR was auto-created by the orphan-recovery path (GH#20819) so the change can land via the normal review and merge pipeline.


Merged via PR #52 to main.
Merged by deterministic merge pass (pulse-wrapper.sh).


aidevops.sh v3.15.38 spent 1m on this as a headless bash routine.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

origin:worker-takeover Worker took over from interactive session

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs update: Ultimate Multisite v2.11.0

1 participant