Skip to content

Conversation

@msanatan
Copy link
Member

@msanatan msanatan commented Jan 22, 2026

Description

Update the example in the README with the latest version + re-organize docs so it's more structured

Type of Change

  • Documentation update

Changes Made

Change release logic and update docs

Testing/Screenshots/Recordings

N/A

Related Issues

N.A

Additional Notes

N/A

Summary by Sourcery

Automate README version updates in the release workflow and refresh fixed-version examples in the English and Chinese READMEs to the latest tag.

CI:

  • Extend the release workflow to update and commit root and Chinese README version references alongside existing Server README changes.

Documentation:

  • Update fixed-version installation examples in README and README-zh to reference version v9.1.0.

Summary by CodeRabbit

  • Chores

    • Updated documentation version references to v9.1.0.
    • Enhanced release workflow to include documentation files in automated version-bump commits.
  • Documentation

    • Reorganized Chinese localization into the docs/i18n locale bundle and removed the top-level duplicate.
    • Updated README links to reference the new docs locations and revised contributing/telemetry reference paths.

✏️ Tip: You can customize this high-level summary in your review settings.

- Add version update for root README.md UPM fixed version examples
- Add version update for README-zh.md UPM and pip fixed version examples
- Include README.md and README-zh.md in release commit
@msanatan msanatan self-assigned this Jan 22, 2026
@sourcery-ai
Copy link
Contributor

sourcery-ai bot commented Jan 22, 2026

Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

This PR extends the release workflow so version bumps in the root and Chinese READMEs are automated alongside the server and package files, and updates the checked-in README examples to v9.1.0.

Sequence diagram for updated release workflow version update step

sequenceDiagram
    actor Developer
    participant GitHubActions
    participant ReleaseWorkflow
    participant VersionUpdateStep
    participant GitRepository

    Developer->>GitHubActions: Push tag / trigger release
    GitHubActions->>ReleaseWorkflow: Start release job
    ReleaseWorkflow->>ReleaseWorkflow: Compute NEW_VERSION
    ReleaseWorkflow->>VersionUpdateStep: Run version update script with NEW_VERSION

    VersionUpdateStep->>GitRepository: Update MCPForUnity/package.json version
    VersionUpdateStep->>GitRepository: Update Server/pyproject.toml version
    VersionUpdateStep->>GitRepository: Update Server/README.md version references
    VersionUpdateStep->>GitRepository: Update README.md fixed version examples
    VersionUpdateStep->>GitRepository: Update README-zh.md fixed version examples

    ReleaseWorkflow->>GitRepository: git add MCPForUnity/package.json
    ReleaseWorkflow->>GitRepository: git add Server/pyproject.toml
    ReleaseWorkflow->>GitRepository: git add Server/README.md
    ReleaseWorkflow->>GitRepository: git add README.md
    ReleaseWorkflow->>GitRepository: git add README-zh.md

    ReleaseWorkflow->>GitRepository: Commit and push version bump
    GitHubActions-->>Developer: Release pipeline completed
Loading

File-Level Changes

Change Details Files
Automate updating version references in all README files during the release workflow.
  • Add sed command to update fixed-version MCPForUnity Git URL in the root README based on NEW_VERSION.
  • Add sed commands to update both the fixed-version MCPForUnity Git URL and Server subdirectory Git URL in README-zh based on NEW_VERSION.
  • Extend the git add step so the release commit includes README.md and README-zh.md when version strings change.
.github/workflows/release.yml
Synchronize checked-in README examples with the latest tagged version.
  • Update the fixed-version MCPForUnity Git URL in the English README from v9.0.3 to v9.1.0.
  • Update the fixed-version MCPForUnity Git URL in the Chinese README from v8.6.0 to v9.1.0.
README.md
README-zh.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 22, 2026

📝 Walkthrough

Walkthrough

Release workflow updated to bump version references and commit documentation changes; Chinese README moved from repository root to docs/i18n/README-zh.md (full localized content added) while the root README-zh.md was removed and README.md links/version references updated.

Changes

Cohort / File(s) Summary
Release workflow
.github/workflows/release.yml
Adds sed commands using NEW_VERSION to update README paths and version references; expands git commit/git add to include README.md and docs/i18n/README-zh.md alongside existing package and server files.
English README updates
README.md
Updated language link to point to docs/i18n/README-zh.md; bumped stable version reference to v9.1.0; updated contributing/telemetry doc paths to docs/....
Chinese localization
README-zh.md (removed), docs/i18n/README-zh.md (added)
Root README-zh.md content removed; comprehensive Chinese README added under docs/i18n/README-zh.md (installation, setup, examples, troubleshooting, branding assets, contribution and telemetry notes).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Poem

🐰
A hop, a tweak, a tidy tune,
Readmes shifted under moon;
Versions bumped, the workflows cheer,
Docs now snug and crystal clear —
I nibble code and twiddle whiskers, hooray for another release!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: automating README version updates on release and reorganizing documentation structure.
Description check ✅ Passed The description follows the template with all required sections completed: Description, Type of Change, Changes Made, Testing, Related Issues, and Additional Notes are all present and filled out.
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.


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
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey - I've left some high level feedback:

  • The repeated sed expressions for updating versioned URLs in multiple READMEs could be extracted into a small script or looped over a list of files to reduce duplication and make future changes less error-prone.
  • The regexes assume strictly x.y.z semantic version tags; if you ever introduce pre-release tags or change tag format, you may want to centralize or loosen these patterns to avoid fragile replacements.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The repeated `sed` expressions for updating versioned URLs in multiple READMEs could be extracted into a small script or looped over a list of files to reduce duplication and make future changes less error-prone.
- The regexes assume strictly `x.y.z` semantic version tags; if you ever introduce pre-release tags or change tag format, you may want to centralize or loosen these patterns to avoid fragile replacements.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
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: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README-zh.md (1)

206-206: Missed version reference still shows v8.6.0.

Line 206 contains an outdated v8.6.0 reference in the manual uvx command, while other version references in this file have been updated to v9.1.0. This creates an inconsistency. The release workflow's sed command (line 93 in release.yml) would update this in future releases, but the current PR leaves it outdated.

📝 Suggested fix
-uvx --from "git+https://github.com/CoplayDev/unity-mcp@v8.6.0#subdirectory=Server" mcp-for-unity --transport http --http-url http://localhost:8080
+uvx --from "git+https://github.com/CoplayDev/unity-mcp@v9.1.0#subdirectory=Server" mcp-for-unity --transport http --http-url http://localhost:8080

- Move README-zh.md to docs/i18n/README-zh.md
- Move development docs to docs/development/ (README-DEV.md, README-DEV-zh.md)
- Move user guides to docs/guides/ (CLI_USAGE.md, CURSOR_HELP.md, MCP_CLIENT_CONFIGURATORS.md)
- Move migration guides to docs/migrations/ (v5_MIGRATION.md, v6_NEW_UI_CHANGES.md, v8_NEW_NETWORKING_SETUP.md)
- Move reference docs to docs/reference/ (CUSTOM_TOOLS.md, TELEMETRY.md)
- Update all internal links in README
@msanatan msanatan merged commit 9682e3c into main Jan 22, 2026
2 checks passed
@msanatan msanatan deleted the marcus/update-readme-on-release branch January 22, 2026 02:35
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.

2 participants