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)

PageCovers
doc/Bowl-flow.mdBowl crash guard — 5-phase remediation pipeline, dual modes, cross-platform strategies, graceful degradation
doc/Drivelution-flow.mdDrivelution driver update — template method pipeline, composable steps, retry/timeout, batch updates
doc/Extension-flow.mdExtension management — 9-stage update chain, dependency resolver, Zip Slip protection, atomic writes
doc/Avalonia.Android-flow.mdAvalonia.Android APK update — 3-step API, resumable download, FileProvider, multi-protocol auth
doc/Maui.Android-flow.mdMaui.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
CopilotAI review requested due to automatic review settings June 25, 2026 07:47

CopilotAI 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
FileDescription
website/sidebars.jsFlattens component reference docs; groups all flow docs under a collapsible “执行流程详解” category.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Maui.Android-flow.mdAdds English Maui.Android execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Extension-flow.mdAdds English Extension execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Drivelution-flow.mdAdds English Drivelution execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Bowl-flow.mdAdds English Bowl execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Avalonia.Android-flow.mdAdds English Avalonia.Android execution-flow deep dive.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Core-flow.mdUpdates Core flow doc sidebar label to be component-specific.
website/i18n/en/docusaurus-plugin-content-docs/current.jsonAdds English translation for the new sidebar category label “执行流程详解”.
website/docs/doc/Maui.Android-flow.mdAdds Chinese Maui.Android execution-flow deep dive.
website/docs/doc/Extension-flow.mdAdds Chinese Extension execution-flow deep dive.
website/docs/doc/Drivelution-flow.mdAdds Chinese Drivelution execution-flow deep dive.
website/docs/doc/Bowl-flow.mdAdds Chinese Bowl execution-flow deep dive.
website/docs/doc/Avalonia.Android-flow.mdAdds Chinese Avalonia.Android execution-flow deep dive.
website/docs/doc/Core-flow.mdUpdates 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
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);
}
}
// 所有重试耗尽,返回最后一次失败结果
}
@JusterZhu
JusterZhu merged commit 657dd34 into mainJun 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 freeto 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

@JusterZhu