Skip to content

fix(docs): correct duplicated text in the Chinese book structure overview image#17

Open
shaun0927 wants to merge 2 commits intolintsinghua:mainfrom
shaun0927:fix/chinese-book-structure-overview-asset
Open

fix(docs): correct duplicated text in the Chinese book structure overview image#17
shaun0927 wants to merge 2 commits intolintsinghua:mainfrom
shaun0927:fix/chinese-book-structure-overview-asset

Conversation

@shaun0927
Copy link
Copy Markdown

Background

Issue #15 reports that the second image in the foreword has duplicated/malformed text.

I reproduced that problem on current main in a local clone:

  • OCR on assets/book_structure_overview.png detected 第3章 工具系统 智能体操作 twice at different vertical positions.
  • OCR also detected malformed title text in the Chinese asset.
  • The English counterpart (en/assets/book_structure_overview.png) did not show the same duplication.

What changed

  • replaced/regenerated assets/book_structure_overview.png
  • removed the duplicated Chapter 3 label in the Chinese asset
  • corrected the malformed top title text in the Chinese asset
  • left the English asset unchanged because local validation did not show a corresponding defect there

Scope

This PR intentionally stays narrow to match the repository's recent merge pattern for documentation fixes:

  • one validated problem
  • one asset changed
  • no unrelated documentation edits

Validation

  • local OCR before: duplicated 第3章 工具系统 智能体操作 appeared twice
  • local OCR after: only one 第3章 工具系统 智能体操作 remains
  • local OCR after: title reads 智能体系统课程路线图:从基础到生产(2021年-至今)
  • PNG format remains valid after the update

Closes #15

The current Chinese `book_structure_overview` asset duplicates the
Chapter 3 label and contains malformed title text. This keeps the
fix narrowly scoped to the one image that issue lintsinghua#15 identifies,
matching the repository's documentation-first contribution pattern.

Constraint: Keep the PR limited to the validated Chinese asset defect
Rejected: Open a new issue in English | duplicate of upstream issue lintsinghua#15
Rejected: Modify the English asset too | local validation showed no corresponding defect
Confidence: medium
Scope-risk: narrow
Reversibility: clean
Directive: If a source design file is introduced later, prefer regenerating this asset from source rather than layering manual edits on top
Tested: Local OCR shows one Chapter 3 label and corrected title text; PNG MIME preserved
Not-tested: Human visual review in GitHub's final renderer
Related: lintsinghua#15
The first fix removed the duplicated Chapter 3 label and corrected
the title text, but the cleared text band could still read as an
editing artifact. This follow-up redraws the left panel so the asset
remains visually consistent while preserving the validated content fix.

Constraint: Stay within the existing one-asset PR scope
Rejected: Leave the OCR-correct but visually patched version as-is | visible cleanup band weakened the polish of the diagram
Rejected: Rebuild additional assets for consistency | no corresponding defect was validated elsewhere
Confidence: medium
Scope-risk: narrow
Reversibility: clean
Directive: If the original design source becomes available, prefer regenerating the asset from source rather than iterating on raster edits
Tested: Local OCR still finds one Chapter 3 label, one Chapter 4 label, and the corrected title text; PNG MIME preserved
Not-tested: Maintainer preference for the redrawn panel styling versus the prior asset styling
Related: lintsinghua#15
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