docs: 重构文档信息架构，分离仓库入口与文档首页

- 新增 DOCS.md 作为 HonKit/GitBook 文档首页，集中承载学习路径与核心文档入口
- 将 README.md/README.zh-CN.md 收敛为仓库入口，仅保留项目概览与快速开始
- 重构 SUMMARY.md 目录结构，按语言和模块分组，提升导航清晰度
- 更新 .gitbook.yaml 和 book.json 的 readme 配置指向 DOCS.md
- 调整 Pages workflow 触发分支为 master,main 并补充 DOCS.md 与 changelog 路径
- 同步更新中英文 gitbook-sync.md 说明，明确默认分支和首页变更
- 新增 changelog 记录本次架构调整的背景、变更细节与验证结果

Author: shijiashuai

.gitbook.yaml

@@ -1,4 +1,4 @@
 root: ./
 structure:
-  readme: README.md
+  readme: DOCS.md
   summary: SUMMARY.md

.github/workflows/pages.yml

@@ -2,12 +2,13 @@ name: Deploy Docs
 
 on:
   push:
-    branches: [main]
+    branches: [master, main]
     paths:
       - "docs/**"
       - "examples/*/README.md"
       - "README.md"
       - "README.zh-CN.md"
+      - "DOCS.md"
       - "SUMMARY.md"
       - "CONTRIBUTING.md"
       - "CONTRIBUTING.zh.md"
@@ -16,6 +17,7 @@ on:
       - "package.json"
       - "package-lock.json"
       - ".github/workflows/pages.yml"
+      - "changelog/**"
   workflow_dispatch:
 
 permissions:
@@ -34,15 +36,15 @@ jobs:
       - uses: actions/checkout@v4
         with:
           sparse-checkout: |
-            docs/en
-            docs/zh
+            docs
             examples/01-cmake-modern/README.md
             examples/02-memory-cache/README.md
             examples/03-modern-cpp/README.md
             examples/04-simd-vectorization/README.md
             examples/05-concurrency/README.md
             README.md
             README.zh-CN.md
+            DOCS.md
             SUMMARY.md
             CONTRIBUTING.md
             CONTRIBUTING.zh.md

DOCS.md

@@ -0,0 +1,47 @@
+# Documentation Home
+
+This site is the documentation entry for the C++ High Performance Computing Optimization Guide. Start here when you want a reading path, a language-specific guide, or direct access to the example modules.
+
+## Project Positioning
+
+- Learn modern C++ performance engineering through runnable examples instead of isolated notes.
+- Cover the path from build system fundamentals to memory and cache behavior, SIMD, concurrency, benchmarking, and profiling.
+- Keep the repository README focused on repository setup while this page focuses on documentation entry points and reading order.
+
+## Who This Is For
+
+- C++ engineers who want a structured path into performance optimization.
+- Students and self-learners comparing optimization techniques with executable examples.
+- Maintainers who need profiling, benchmarking, and contribution references.
+
+## Start Here
+
+- English readers: [Learning Path](docs/en/learning-path.md)
+- 中文读者: [学习路径](docs/zh/learning-path.md)
+- Need tooling first: [Profiling Guide](docs/en/profiling-guide.md) and [性能分析指南](docs/zh/profiling-guide.md)
+- Need site sync details: [GitBook Sync Guide](docs/en/gitbook-sync.md) and [GitBook 接入指南](docs/zh/gitbook-sync.md)
+
+## Recommended Reading Paths
+
+| Goal | Recommended path |
+| --- | --- |
+| First visit | Learning Path -> example modules -> profiling guide |
+| Benchmark or hotspot analysis | Profiling Guide -> memory and cache module -> SIMD module |
+| Add or extend a module | Contributing guide -> relevant module README -> learning path |
+
+## Core Documents
+
+| Topic | English | 中文 |
+| --- | --- | --- |
+| Learning path | [Learning Path](docs/en/learning-path.md) | [学习路径](docs/zh/learning-path.md) |
+| Profiling | [Profiling Guide](docs/en/profiling-guide.md) | [性能分析指南](docs/zh/profiling-guide.md) |
+| Site sync | [GitBook Sync Guide](docs/en/gitbook-sync.md) | [GitBook 接入指南](docs/zh/gitbook-sync.md) |
+| Contribution | [Contributing](CONTRIBUTING.md) | [参与贡献](CONTRIBUTING.zh.md) |
+
+## Example Modules
+
+- [01 - Modern CMake](examples/01-cmake-modern/README.md)
+- [02 - Memory & Cache Optimization](examples/02-memory-cache/README.md)
+- [03 - Modern C++ Features](examples/03-modern-cpp/README.md)
+- [04 - SIMD Vectorization](examples/04-simd-vectorization/README.md)
+- [05 - Concurrency](examples/05-concurrency/README.md)

README.md

@@ -1,162 +1,33 @@
 # C++ High Performance Computing Optimization Guide
 
-English | [简体中文](README.zh-CN.md) | [GitBook Sync Guide](docs/en/gitbook-sync.md)
+English | [简体中文](README.zh-CN.md) | [Documentation Home](https://lessup.github.io/cpp-high-performance-guide/)
 
-[![Build](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/build.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Build)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/build.yml)
-[![Benchmarks](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/benchmark.yml?branch=main&style=for-the-badge&logo=speedtest&logoColor=white&label=Benchmarks)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/benchmark.yml)
-[![Sanitizers](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/sanitizers.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Sanitizers)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/sanitizers.yml)
-[![Docs](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/pages.yml?branch=main&style=for-the-badge&logo=githubpages&logoColor=white&label=Docs)](https://lessup.github.io/cpp-high-performance-guide/)
+A modern C++20 example collection for learning performance engineering across build systems, memory and cache behavior, SIMD, concurrency, benchmarking, and profiling.
 
-A comprehensive collection of high-performance computing optimization examples and best practices for modern C++20.
+## Repository Overview
 
-## Features
-
-- **Modern CMake Build System** - Target-based CMake with presets, FetchContent dependencies
-- **Memory & Cache Optimization** - AOS vs SOA, false sharing, alignment, prefetching
-- **Modern C++ Features** - constexpr, move semantics, vector reserve, C++20 ranges
-- **SIMD Vectorization** - Auto-vectorization, SSE/AVX2/AVX-512 intrinsics, wrapper library
-- **Concurrency** - Atomic operations, lock-free queues, OpenMP integration
-- **Benchmarking Framework** - Google Benchmark integration, FlameGraph generation
+- `examples/`: five themed modules covering modern CMake, memory and cache optimization, modern C++ features, SIMD, and concurrency.
+- `benchmarks/` and `tools/`: benchmark runners, FlameGraph helpers, and analysis scripts.
+- `docs/`: bilingual learning path, profiling guide, and HonKit or GitBook synchronization notes.
+- `tests/`: unit, integration, and property-style checks for the example collection.
 
 ## Quick Start
 
-### Prerequisites
-
-- C++20 compatible compiler (GCC 11+, Clang 14+)
-- CMake 3.20+
-- Ninja (recommended) or Make
-
-### Build
-
 ```bash
-# Clone the repository
-git clone https://github.com/LessUp/cpp-high-performance-guide.git
-cd cpp-high-performance-guide
-
-# Configure and build (Release mode)
 cmake --preset=release
 cmake --build build/release
-
-# Run all benchmarks
-cd build/release && ctest --output-on-failure
-```
-
-### Available Presets
-
-| Preset | Description |
-|--------|-------------|
-| `debug` | Debug build with symbols |
-| `release` | Optimized release build (-O3, -march=native) |
-| `asan` | AddressSanitizer enabled |
-| `tsan` | ThreadSanitizer enabled |
-
-```bash
-# Build with sanitizers
-cmake --preset=asan
-cmake --build build/asan
-```
-
-## Project Structure
-
-```
-cpp-high-performance-guide/
-├── cmake/                      # CMake modules
-│   ├── CompilerOptions.cmake   # Compiler flags management
-│   ├── Dependencies.cmake      # FetchContent dependencies
-│   ├── Sanitizers.cmake        # Sanitizer configuration
-│   └── ExampleTemplate.cmake   # Example module template
-├── examples/
-│   ├── 01-cmake-modern/        # CMake best practices vs anti-patterns
-│   ├── 02-memory-cache/        # Memory and cache optimization
-│   ├── 03-modern-cpp/          # Modern C++ features
-│   ├── 04-simd-vectorization/  # SIMD and vectorization
-│   └── 05-concurrency/         # Concurrent programming
-├── benchmarks/                 # Benchmark utilities
-├── tests/                      # Unit and property tests
-├── tools/                      # Analysis and profiling tools
-└── docs/                       # Documentation
-```
-
-## Example Modules
-
-### 01 - Modern CMake
-Learn CMake best practices through anti-pattern vs best-practice comparisons.
-- Target-based vs directory-based commands
-- FetchContent dependency management
-- Compiler options management
-
-### 02 - Memory & Cache Optimization
-Master cache-friendly programming techniques.
-- **AOS vs SOA**: Data layout impact on performance
-- **False Sharing**: Multi-threaded cache line contention
-- **Alignment**: SIMD-friendly memory alignment
-- **Prefetching**: Manual prefetch hints
-
-### 03 - Modern C++ Features
-Leverage modern C++ for performance.
-- **constexpr/consteval**: Compile-time computation
-- **Move Semantics**: Avoid unnecessary copies
-- **Vector Reserve**: Reduce allocations
-- **C++20 Ranges**: Modern iteration patterns
-
-### 04 - SIMD Vectorization
-Maximize CPU throughput with SIMD.
-- **Auto-vectorization**: Compiler-friendly patterns
-- **Intrinsics**: SSE, AVX2, AVX-512 examples
-- **SIMD Wrapper**: Readable SIMD abstractions
-
-### 05 - Concurrency
-Write efficient multi-threaded code.
-- **Atomic Operations**: Memory ordering explained
-- **Lock-Free Queue**: SPSC queue implementation
-- **OpenMP**: Simple parallelization patterns
-
-## Running Benchmarks
-
-```bash
-# Run all benchmarks
-cd build/release
-ctest --output-on-failure
-
-# Run specific benchmark
-./examples/02-memory-cache/bench/aos_soa_bench
-
-# Export benchmark results to JSON
-./examples/02-memory-cache/bench/aos_soa_bench --benchmark_format=json > results.json
-```
-
-## Profiling
-
-Generate FlameGraph visualizations:
-
-```bash
-# Record performance data
-./tools/flamegraph/generate_flamegraph.sh ./build/release/examples/02-memory-cache/bench/aos_soa_bench
-
-# View the generated SVG
-firefox flamegraph.svg
+ctest --preset=release
 ```
 
 ## Documentation
 
-- [Learning Path](docs/en/learning-path.md) - Recommended order for studying examples
-- [Profiling Guide](docs/en/profiling-guide.md) - How to profile and analyze performance
-- [GitBook Sync Guide](docs/en/gitbook-sync.md) - Connect this repository to GitBook for online reading
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Ensure all tests pass with sanitizers
-4. Submit a pull request
-
-## License
-
-MIT License - see [LICENSE](LICENSE) for details.
+- Docs site: https://lessup.github.io/cpp-high-performance-guide/
+- Learning path: `docs/en/learning-path.md` and `docs/zh/learning-path.md`
+- Profiling guide: `docs/en/profiling-guide.md` and `docs/zh/profiling-guide.md`
+- HonKit or GitBook sync notes: `docs/en/gitbook-sync.md` and `docs/zh/gitbook-sync.md`
 
-## Acknowledgments
+## Development
 
-- [Google Benchmark](https://github.com/google/benchmark)
-- [Google Test](https://github.com/google/googletest)
-- [RapidCheck](https://github.com/emil-e/rapidcheck)
-- [FlameGraph](https://github.com/brendangregg/FlameGraph)
+- Contribution guide: `CONTRIBUTING.md` and `CONTRIBUTING.zh.md`
+- Changelog: `changelog/`
+- License: `LICENSE`