docs: remove GeneralUpdate.ClientCore, merge ClientCore and Common into Core by JusterZhu · Pull Request #67 · GeneralLibrary/GeneralUpdate-Samples

JusterZhu · 2026-06-01T04:43:46Z

Summary

GeneralUpdate.ClientCore and GeneralUpdate.Common have been merged into GeneralUpdate.Core. This PR updates the documentation to reflect this consolidation.

Changes

Deletions

Remove GeneralUpdate.ClientCore.md (3 copies: base, zh-Hans i18n, en i18n)

Core component page (GeneralUpdate.Core.md)

Rewrite component overview: Core is now the unified component providing:
- Client update management (formerly ClientCore)
- Upgrade execution engine
- Shared infrastructure (formerly Common)
Replace all using GeneralUpdate.ClientCore / using GeneralUpdate.Common.* with using GeneralUpdate.Core
Add migration notes for existing users
Update related components section

Cross-page updates

GeneralTracer.md: Update namespace to GeneralUpdate.Core, add merge notice
GeneralClient.OSS.md: Update namespace to GeneralUpdate.Core, remove ClientCore dependency
UpgradeHub.md: Update namespace to GeneralUpdate.Core.Hubs
Differential.md / Extension.md / PacketTool.md: Fix cross-page links (ClientCore -> Core)

Migration summary

Before:  dotnet add package GeneralUpdate.ClientCore
Before:  using GeneralUpdate.ClientCore;
Before:  using GeneralUpdate.Common.Shared.Object;

After:   dotnet add package GeneralUpdate.Core
After:   using GeneralUpdate.Core;

Validation

npm run build -- --no-minify passes
No remaining ClientCore/Common references in non-releaselog pages

Copilot

Pull request overview

This PR updates the Docusaurus documentation to reflect the consolidation of GeneralUpdate.ClientCore and GeneralUpdate.Common into a single unified package/namespace: GeneralUpdate.Core.

Changes:

Removed the standalone GeneralUpdate.ClientCore documentation pages (base + i18n copies).
Updated namespaces/assemblies/usings across docs to GeneralUpdate.Core / GeneralUpdate.Core.*.
Adjusted cross-page links and added merge/migration notes (including GeneralTracer, UpgradeHub, OSS docs).

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/UpgradeHub.md	Update UpgradeHub docs to `GeneralUpdate.Core.Hubs` + `GeneralUpdate.Core.dll`.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.PacketTool.md	Replace ClientCore doc link with Core in “ecosystem” references.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md	Update “See also” link from ClientCore to Core.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Differential.md	Replace “ClientCore BackUp” wording with “Core BackUp”.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Core.md	Rewrite overview to reflect unified Core; remove `Common.*` usings; add migration notes.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.ClientCore.md	Delete ClientCore page (merged into Core).
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralTracer.md	Update `GeneralTracer` namespace/assembly and add merge notice.
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralClient.OSS.md	Update OSS docs to `GeneralUpdate.Core` package/namespace.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/UpgradeHub.md	Update UpgradeHub docs to `GeneralUpdate.Core.Hubs` + `GeneralUpdate.Core.dll`.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.PacketTool.md	Replace ClientCore doc link with Core in “ecosystem” references.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md	Update “See also” link from ClientCore to Core.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Differential.md	Replace “ClientCore BackUp” wording with “Core BackUp”.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Core.md	Rewrite overview to reflect unified Core; remove `Common.*` usings; add migration notes.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.ClientCore.md	Delete ClientCore page (merged into Core).
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralTracer.md	Update `GeneralTracer` namespace/assembly and add merge notice.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralClient.OSS.md	Update OSS docs to `GeneralUpdate.Core` package/namespace.
website/docs/doc/UpgradeHub.md	Update UpgradeHubService docs and examples to Core package/namespace.
website/docs/doc/GeneralUpdate.PacketTool.md	Replace ClientCore doc link with Core in “ecosystem” references.
website/docs/doc/GeneralUpdate.Extension.md	Update “See also” link from ClientCore to Core.
website/docs/doc/GeneralUpdate.Differential.md	Replace “ClientCore BackUp” wording with “Core BackUp”.
website/docs/doc/GeneralUpdate.Core.md	Rewrite overview to reflect unified Core; remove `Common.*` usings; add migration notes.
website/docs/doc/GeneralUpdate.ClientCore.md	Delete ClientCore page (merged into Core).
website/docs/doc/GeneralTracer.md	Update `GeneralTracer` namespace/assembly and add merge notice.
website/docs/doc/GeneralClient.OSS.md	Update OSS docs to `GeneralUpdate.Core` package/namespace.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

 5. **回滚机制**
   - Core 不直接提供回滚功能,但保留了备份文件
-   - 如需回滚,可使用 ClientCore 的备份功能
+   - Core 提供内置的备份与回滚机制，无需额外组件


 5. **Rollback Mechanism**
   - Core does not directly provide rollback functionality, but backup files are preserved
-   - For rollback, use ClientCore's backup functionality
+   - Core provides built-in backup and rollback, no extra components needed


 5. **回滚机制**
   - Core 不直接提供回滚功能,但保留了备份文件
-   - 如需回滚,可使用 ClientCore 的备份功能
+   - Core 提供内置的备份与回滚机制，无需额外组件


 - **[GeneralUpdate.Core](./GeneralUpdate.Core.md)** - 核心更新组件
 - **[GeneralUpdate.Extension](./GeneralUpdate.Extension.md)** - 扩展管理系统
- **[GeneralUpdate.ClientCore](./GeneralUpdate.ClientCore.md)** - 客户端更新组件
+- **[GeneralUpdate.Core](./GeneralUpdate.Core.md)** - 客户端更新组件
 - **[快速入门指南](../quickstart/Quik%20start.md)** - GeneralUpdate 快速入门 GeneralUpdate quick start


 - **[GeneralUpdate.Core](./GeneralUpdate.Core.md)** - Core update component
 - **[GeneralUpdate.Extension](./GeneralUpdate.Extension.md)** - Extension management system
- **[GeneralUpdate.ClientCore](./GeneralUpdate.ClientCore.md)** - Client update component
+- **[GeneralUpdate.Core](./GeneralUpdate.Core.md)** - Client update component
 - **[Quick Start Guide](../quickstart/Quik%20start.md)** - GeneralUpdate quick start


+- [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 主客户端更新组件
 - [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 核心更新逻辑


+- [GeneralUpdate.Core](./GeneralUpdate.Core.md) - Main client update component
 - [GeneralUpdate.Core](./GeneralUpdate.Core.md) - Core update logic


+- [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 主客户端更新组件
 - [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 核心更新逻辑


 - **示例代码：** [查看 GitHub 示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/blob/main/src/Push/Program.cs)
 - **主仓库：** [GeneralUpdate 项目](https://github.com/GeneralLibrary/GeneralUpdate)
- **相关组件：** [GeneralUpdate.ClientCore](./GeneralUpdate.ClientCore.md) | [GeneralUpdate.Core](./GeneralUpdate.Core.md)
+- **相关组件：** [GeneralUpdate.Core](./GeneralUpdate.Core.md) | [GeneralUpdate.Core](./GeneralUpdate.Core.md)


+
+
+
+



- Delete GeneralUpdate.ClientCore.md (3 copies) — component merged into Core - Rewrite Core component overview: Core is now the unified component encompassing client-side management (formerly ClientCore), upgrade execution, and shared infrastructure (formerly Common) - Update all code examples: replace using GeneralUpdate.ClientCore / using GeneralUpdate.Common.* with using GeneralUpdate.Core - Add migration notes explaining the merge for existing users - Update GeneralTracer: Common merged into Core, no separate package needed - Update GeneralClient.OSS: namespace Core, remove ClientCore dependency - Update UpgradeHub: namespace Core.Hubs, remove ClientCore references - Fix cross-page links: ClientCore -> Core in Differential, Extension, PacketTool - Clean all references to removed components (excluding historical releaselog) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

JusterZhu · 2026-06-03T08:08:12Z

Part of #45 — resolves the open question about whether ClientCore/Common should be merged into component structure.

Copilot AI review requested due to automatic review settings June 1, 2026 04:43

Copilot started reviewing on behalf of JusterZhu June 1, 2026 04:43 View session

Copilot AI reviewed Jun 1, 2026

View reviewed changes

JusterZhu force-pushed the docs/merge-clientcore-common-into-core branch 2 times, most recently from 5b10429 to 3207432 Compare June 3, 2026 07:35

JusterZhu force-pushed the docs/merge-clientcore-common-into-core branch from 3207432 to b66f37c Compare June 3, 2026 07:39

JusterZhu merged commit 5a28077 into main Jun 3, 2026
1 check passed

This was referenced Jun 3, 2026

Docs subtask: final consistency review and documentation validation #55

Closed

Documentation proposal: non-firmware component docs and dual-track cookbooks #45

Closed

JusterZhu deleted the docs/merge-clientcore-common-into-core branch June 3, 2026 16:47

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: remove GeneralUpdate.ClientCore, merge ClientCore and Common into Core#67

docs: remove GeneralUpdate.ClientCore, merge ClientCore and Common into Core#67
JusterZhu merged 1 commit into
mainfrom
docs/merge-clientcore-common-into-core

JusterZhu commented Jun 1, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

JusterZhu commented Jun 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		- [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 主客户端更新组件
		- [GeneralUpdate.Core](./GeneralUpdate.Core.md) - 核心更新逻辑

Uh oh!

Conversation

JusterZhu commented Jun 1, 2026

Summary

Changes

Deletions

Core component page (GeneralUpdate.Core.md)

Cross-page updates

Migration summary

Validation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

JusterZhu commented Jun 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants