Skip to content

docs: apply mechanical doc-review fixes#677

Merged
kcenon merged 2 commits into
developfrom
feature/docs-fix-2026-04-15
Apr 15, 2026
Merged

docs: apply mechanical doc-review fixes#677
kcenon merged 2 commits into
developfrom
feature/docs-fix-2026-04-15

Conversation

@kcenon

@kcenon kcenon commented Apr 15, 2026

Copy link
Copy Markdown
Owner

Summary

Mechanical doc-review fixes from cross-system audit.

  • Broken anchors and cross-references repaired
  • Version refs aligned with vcpkg.json/CMakeLists.txt
  • Missing targets wrapped with <!-- TODO --> markers
  • docs/advanced/README*.md depth-drift fixes (~14 links each)

Why

157 findings (89 Must-Fix, 61 Should-Fix, 7 Nice-to-Have). Korean .kr.md sync and unnamed-SSOT decisions deferred.

How

  • Phase-1 regression check: 0 regressions, 32 residuals (policy-deferred)

See DOC_REVIEW_REPORT.md at repo root.

Test Plan

Doc-only changes. No code modifications. No breaking changes.

  • Phase-1 re-validation passed (0 regressions)
  • CI green (pending this PR)

kcenon added 2 commits April 15, 2026 06:55
Phase 1 (Must-Fix): resolve wrong relative paths in docs/advanced/
README*.md and related advanced/ files; fix CHANGELOG CONTRIBUTING/
LICENSE links to repo root; correct BUILD_GUIDE, API_REFERENCE, and
PERFORMANCE cross-refs; mark non-existent targets (DESIGN_IMPROVEMENTS,
PLATFORM_BUILD_GUIDE, LOG_LEVEL_UNIFICATION_PLAN, Korean translations,
integration sub-guides) with TODO markers. Fix formatter_macros anchor
slug in API_REFERENCE, PATTERNS section-number anchors in FAQ files,
and mark FAQ TOC drift in docs/guides/FAQ.md and docs/advanced/
PERFORMANCE.kr.md.

Phase 2 (Should-Fix): align CONTRIBUTING.md and PROJECT_STRUCTURE*
compiler baseline with README.md (GCC 13+/Clang 17+/MSVC 2022+).
Downgrade docs/performance/BASELINE.md status from Released to Draft
since all benchmark cells remain TBD; add explicit TODO marker on the
primary TBD table.
@kcenon kcenon merged commit 965ad82 into develop Apr 15, 2026
1 check passed
@kcenon kcenon deleted the feature/docs-fix-2026-04-15 branch April 15, 2026 08:36
@kcenon kcenon mentioned this pull request Apr 15, 2026
8 tasks
kcenon added a commit that referenced this pull request Apr 15, 2026
* docs: apply mechanical doc-review fixes (#677)

* docs: fix 74 broken links, 5 anchors, 4 version refs

Phase 1 (Must-Fix): resolve wrong relative paths in docs/advanced/
README*.md and related advanced/ files; fix CHANGELOG CONTRIBUTING/
LICENSE links to repo root; correct BUILD_GUIDE, API_REFERENCE, and
PERFORMANCE cross-refs; mark non-existent targets (DESIGN_IMPROVEMENTS,
PLATFORM_BUILD_GUIDE, LOG_LEVEL_UNIFICATION_PLAN, Korean translations,
integration sub-guides) with TODO markers. Fix formatter_macros anchor
slug in API_REFERENCE, PATTERNS section-number anchors in FAQ files,
and mark FAQ TOC drift in docs/guides/FAQ.md and docs/advanced/
PERFORMANCE.kr.md.

Phase 2 (Should-Fix): align CONTRIBUTING.md and PROJECT_STRUCTURE*
compiler baseline with README.md (GCC 13+/Clang 17+/MSVC 2022+).
Downgrade docs/performance/BASELINE.md status from Released to Draft
since all benchmark cells remain TBD; add explicit TODO marker on the
primary TBD table.

* docs: add post-fix re-validation report

* docs(version): update documentation, CHANGELOG, and version for v1.0.0 (#678)

* chore(version): bump version to 1.0.0

Update project version from 0.3.1 to 1.0.0 in CMakeLists.txt
and vcpkg.json for the stable v1.0 release.

* docs(changelog): add v1.0.0 release section

Summarize all changes since 0.3.1: queue consolidation, Result<T>
migration, API freeze, CMake rename, performance improvements,
and comprehensive documentation overhaul.

* docs(version): update version refs and coverage claim across all docs

Update FetchContent GIT_TAG from v0.3.0 to v1.0.0 in README, guides,
and migration docs. Correct code coverage claim from 72% to 49%
(verified via Codecov). Update doc frontmatter versions to 1.0.0.
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