Skip to content

Point README at the manual - #29

Merged
koriym merged 4 commits into
1.xfrom
readme-manual-sync
Sep 5, 2026
Merged

koriym merged 4 commits into
1.xfrom
readme-manual-sync

Conversation

@koriym

@koriym koriym commented Sep 5, 2026

Copy link
Copy Markdown
Member

README and the manual page (https://bearsunday.github.io/manuals/1.0/en/async.html) carried the same technical content and had drifted. The manual is now the canonical reference (bearsunday/bearsunday.github.io#401); README keeps the example, install, the execution-mode table, links, and the demo commands.

The 0.4.0 migration note linked a README section that no longer exists; it now links the manual section.

Merge after bearsunday/bearsunday.github.io#401 so the section anchors resolve.

README and the manual page carried the same technical content and had
drifted (the README got the install-order fix and 0.4.0 hardening, the
manual did not). The manual is now the canonical reference; README keeps
the example, install, the execution-mode table, links, and the demo
commands. The 0.4.0 migration note linked a README section that no
longer exists; it now links the manual section.
@coderabbitai

coderabbitai Bot commented Sep 5, 2026 •

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 353a7cee-08dd-4050-a568-3c86275fb3e2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: e0fdc01f-253d-4650-b725-d2bbcd2f5d7d

📥 Commits

Reviewing files that changed from the base of the PR and between ceeb47e and bf36cd0.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • README.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The README now provides a concise overview of parallel #[Embed] execution, requirements, installation, demos, and documentation. The changelog links SQL resource migration guidance to the online manual.

Changes

Documentation alignment

Layer / File(s) Summary
README and migration guidance
README.md, CHANGELOG.md
The README replaces detailed technical guidance with concise execution requirements and setup instructions. The changelog links SQL resource migration guidance to the online manual.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to bf36c

The README and migration guidance now direct users to the canonical async manual while retaining installation, execution, and demo guidance. No current merge-blocking product risk is identified.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: directing the README to the manual.
Description check ✅ Passed The description accurately explains the README reduction, the manual as the canonical reference, the migration-link update, and the merge dependency.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-manual-sync

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.

@koriym

koriym commented Sep 5, 2026

Copy link
Copy Markdown
Member Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Sep 5, 2026 •

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

The four pool module usage examples still installed PackageModule before
AsyncSwooleModule, the order #28 corrected everywhere else. Ray.Di keeps
the first binding, so the examples as written left #[Embed] sequential.
Installing AsyncSwooleModule inside AppModule makes every entrypoint
async and is the only reason the PackageModule ordering mattered.
BEAR.Package resolves the swoole context token to
{App}\Module\SwooleModule and wraps AppModule with it, so the async
bindings take precedence by construction and AppModule stays sequential
for bin/app.php. The demo already works this way. Usage examples in the
six module docblocks, the README table, and the changelog line now show
the context module.
@koriym

koriym commented Sep 5, 2026

Copy link
Copy Markdown
Member Author

Two follow-up commits:

  • 3f9b800 The four pool module docblocks still installed PackageModule before AsyncSwooleModule (flagged by CodeRabbit on Make the async manual the canonical BEAR.Async reference bearsunday.github.io#401).
  • 86595db Documented usage moved from "install AsyncSwooleModule in AppModule" to a swoole context module ({App}\Module\SwooleModule), matching how demo/src/Module/SwooleModule.php already works. A context module wraps AppModule, so the async bindings win by construction and AppModule stays sequential for bin/app.php; the PackageModule ordering note becomes a "do not install inside AppModule" note. Six docblocks, the README table, and the Unreleased changelog line follow.

No code change; composer tests green (153 tests).

@koriym

koriym commented Sep 5, 2026

Copy link
Copy Markdown
Member Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Sep 5, 2026 •

Copy link
Copy Markdown
⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

AsyncEmbedModule said twice that AsyncSwooleModule includes it; the pool
modules repeated "AppModule stays unchanged" five times across the
package; the AsyncSwooleModule note explained bin/app.php, which is the
manual's job. Keep the one warning that guards a silent failure (not
inside AppModule) in AsyncSwooleModule only, and list ext-openswoole in
its requirements.
@koriym
koriym merged commit aced82b into 1.x Sep 5, 2026
26 checks passed
@koriym
koriym deleted the readme-manual-sync branch September 5, 2026 18:39
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