feat(docs): add execution flow docs for Bowl, Drivelution, Extension, Avalonia.Android, Maui.Android by JusterZhu · Pull Request #141 · GeneralLibrary/GeneralUpdate-Samples · GitHub
Skip to content

feat(docs): add execution flow docs for Bowl, Drivelution, Extension, Avalonia.Android, Maui.Android#141

Merged
JusterZhu merged 1 commit into
mainfrom
feat/flow-docs-bowl-drivelution-extension-mobile
Jun 25, 2026
Merged

feat(docs): add execution flow docs for Bowl, Drivelution, Extension, Avalonia.Android, Maui.Android#141
JusterZhu merged 1 commit into
mainfrom
feat/flow-docs-bowl-drivelution-extension-mobile

Conversation

@JusterZhu

Copy link
Copy Markdown
Collaborator

Summary

Adds 5 new Chinese flow documentation pages and 5 corresponding English translations, following the same deep-dive format as the existing Core-flow.md.

New docs (Chinese)

Page Covers
doc/Bowl-flow.md Bowl crash guard — 5-phase remediation pipeline, dual modes, cross-platform strategies, graceful degradation
doc/Drivelution-flow.md Drivelution driver update — template method pipeline, composable steps, retry/timeout, batch updates
doc/Extension-flow.md Extension management — 9-stage update chain, dependency resolver, Zip Slip protection, atomic writes
doc/Avalonia.Android-flow.md Avalonia.Android APK update — 3-step API, resumable download, FileProvider, multi-protocol auth
doc/Maui.Android-flow.md Maui.Android APK update — 2-step combined API, Interlocked concurrency, #if ANDROID guard

New docs (English i18n)

Corresponding English translations for all 5 pages under i18n/en/.../doc/.

Sidebar changes

Restructured Components section: all component reference docs are flat, and all flow docs are grouped under a collapsible 执行流程详解 / Execution Flow category at the bottom.

Other changes

  • Updated sidebar_label for all flow docs to use component-specific names (e.g., "Bowl 执行流程" instead of "执行流程详解")
  • Added English i18n translation for the new sidebar category

🤖 Generated with Claude Code

… Avalonia.Android, Maui.Android

- Add 5 new Chinese flow docs (Bowl/Drivelution/Extension/Avalonia.Android/Maui.Android)
- Add 5 corresponding English i18n translations
- Restructure sidebar: group all flow docs under a collapsible '执行流程详解' category
- Update sidebar_label for all flow docs with component-specific names
- Add English i18n label for the new category
Copilot AI review requested due to automatic review settings June 25, 2026 07:47

Copilot AI 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.

Pull request overview

This PR expands the documentation set by adding execution-flow deep-dive pages for multiple GeneralUpdate components (Chinese originals plus English i18n translations) and reorganizes the Docusaurus sidebar to group all flow docs under a dedicated collapsible category.

Changes:

  • Added 5 new execution-flow deep-dive docs under website/docs/doc/ (Chinese).
  • Added corresponding 5 English i18n docs under website/i18n/en/.../doc/.
  • Updated sidebar structure and adjusted flow-doc sidebar_labels (including Core) to be component-specific, plus added an i18n sidebar category label.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
website/sidebars.js Flattens component reference docs; groups all flow docs under a collapsible “执行流程详解” category.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Maui.Android-flow.md Adds English Maui.Android execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Extension-flow.md Adds English Extension execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Drivelution-flow.md Adds English Drivelution execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Bowl-flow.md Adds English Bowl execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Avalonia.Android-flow.md Adds English Avalonia.Android execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Core-flow.md Updates Core flow doc sidebar label to be component-specific.
website/i18n/en/docusaurus-plugin-content-docs/current.json Adds English translation for the new sidebar category label “执行流程详解”.
website/docs/doc/Maui.Android-flow.md Adds Chinese Maui.Android execution-flow deep dive.
website/docs/doc/Extension-flow.md Adds Chinese Extension execution-flow deep dive.
website/docs/doc/Drivelution-flow.md Adds Chinese Drivelution execution-flow deep dive.
website/docs/doc/Bowl-flow.md Adds Chinese Bowl execution-flow deep dive.
website/docs/doc/Avalonia.Android-flow.md Adds Chinese Avalonia.Android execution-flow deep dive.
website/docs/doc/Core-flow.md Updates Core flow doc sidebar label to be component-specific.

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


```csharp
// UpdateFileStore.ReplaceTemporaryWithFinal
File.Move(temporaryPath, targetPath); // Atomic rename
Comment on lines +231 to +246
public async Task<PipelineResult> ExecuteAsync(
Func<CancellationToken, Task<PipelineResult>> action, CancellationToken ct)
{
for (int attempt = 0; attempt <= MaxRetries; attempt++)
{
var result = await action(ct);
if (result.Success) return result;
if (attempt < MaxRetries)
{
var delay = UseExponentialBackoff
? RetryIntervalMs * Math.Pow(2, attempt)
: RetryIntervalMs;
await Task.Delay((int)delay, ct);
}
}
}
Comment on lines +286 to +304
@JusterZhu JusterZhu merged commit 657dd34 into main Jun 25, 2026
3 checks passed
@JusterZhu JusterZhu deleted the feat/flow-docs-bowl-drivelution-extension-mobile branch June 25, 2026 08:18
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