Skip to content

Commit c20c1f1

Browse files
Merge pull request #11 from Awesome-Embedded-Learning-Studio/optimize/update_readme
feat: update the meta info of project
2 parents 2a859ea + 6c2f520 commit c20c1f1

5 files changed

Lines changed: 74 additions & 63 deletions

File tree

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2025 Charliechen
3+
Copyright (c) 2025-2026 Charliechen
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.en.md

Lines changed: 38 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -2,70 +2,79 @@
22

33
[中文](README.md) | English
44

5+
> A systematic modern C++ tutorial -- from foundational syntax to embedded practice, with compilable code examples for every concept
6+
7+
<p align="center">
8+
<a href="https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/">
9+
<img src="https://img.shields.io/badge/📖_Read_Docs_Online-Live-blue?style=for-the-badge" alt="Online Docs">
10+
</a>
11+
</p>
12+
513
![C++](https://img.shields.io/badge/C%2B%2B-11%20%7C%2014%20%7C%2017%20%7C%2020%20%7C%2023-blue?logo=c%2B%2B)
614
![Release](https://img.shields.io/github/v/release/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
715
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
8-
![Stars](https://img.shields.io/github/stars/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
9-
![Issues](https://img.shields.io/github/issues/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
1016
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
11-
[![Docs](https://img.shields.io/badge/docs-online-blue)](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/)
12-
13-
> A systematic modern C++ tutorial -- from foundational syntax to embedded practice, from the standard library in depth to concurrent programming, with compilable code examples for every concept
1417

1518
---
1619

1720
## Highlights
1821

19-
- **Systematic Learning Path** -- 8 volumes from beginner to advanced, each with clear prerequisites, building progressively
20-
- **Practice-Driven** -- Every concept comes with a compilable CMake project, not isolated code snippets
21-
- **Multi-Platform Coverage** -- STM32 / ESP32 / RP2040 embedded practice, going beyond desktop
22-
- **Tag Navigation** -- Browse articles by topic, C++ standard, difficulty, platform, and more
23-
- **Online Reading** -- MkDocs documentation site with search and navigation
22+
- **9-Volume System** -- From C crash course to embedded practice, forming a complete learning loop
23+
- **Compilable Examples** -- Every concept comes with a CMake project, not isolated code snippets
24+
- **Embedded Practice** -- STM32 / ESP32 / RP2040 multi-platform real hardware projects
25+
- **Tag Navigation** -- Browse articles by topic, C++ standard, difficulty, and platform
26+
- **Online Reading** -- Full-featured documentation site with search, navigation, and dark mode
2427

2528
---
2629

2730
## Content Architecture
2831

2932
```mermaid
3033
graph LR
31-
V1["Volume 1 Fundamentals"] --> V2["Volume 2 Modern Features"]
32-
V2 --> V3["Volume 3 Std Library"] & V4["Volume 4 Advanced"] & V5["Volume 5 Concurrency"] & V6["Volume 6 Performance"] & V7["Volume 7 Engineering"]
33-
V2 --> V8["Volume 8 Domain Apps"]
34+
V1["Vol.1 Fundamentals"] --> V2["Vol.2 Modern Features"]
35+
V2 --> V3["Vol.3 Std Library"] & V4["Vol.4 Advanced"] & V5["Vol.5 Concurrency"] & V6["Vol.6 Performance"] & V7["Vol.7 Engineering"]
36+
V2 --> V8["Vol.8 Domain Apps"]
3437
V8 --> E["Embedded"] & N["Networking"] & G["GUI"] & D["Data"] & A["Algorithms"]
38+
V2 --> V9["Vol.9 Open Source"]
39+
V9 --> OC["Chrome Code Study"] & OS["Other Projects"]
3540
```
3641

37-
### Tutorial Structure
42+
<details>
43+
<summary>Volume details and progress</summary>
3844

3945
| Volume | Topic | Articles | Difficulty | Status |
4046
|:--:|------|:------:|:----:|:----:|
4147
| 1 | [C++ Fundamentals](documents/vol1-fundamentals/) -- types, control flow, functions, pointers, classes, template basics | 49 | beginner | Completed |
42-
| 2 | [Modern C++ Features](documents/vol2-modern-features/) -- move semantics, smart pointers, constexpr, Lambda | 35-40 | intermediate | Completed |
48+
| 2 | [Modern C++ Features](documents/vol2-modern-features/) -- move semantics, smart pointers, constexpr, Lambda | 44 | intermediate | Completed |
4349
| 3 | [Standard Library In Depth](documents/vol3-standard-library/) -- containers, iterators, algorithms, strings, allocators | 40-50 | intermediate | Planned |
4450
| 4 | [Advanced Topics](documents/vol4-advanced/) -- Concepts, Ranges, coroutines, modules, template metaprogramming | 50-60 | advanced | Planned |
4551
| 5 | [Concurrent Programming](documents/vol5-concurrency/) -- thread primitives, atomic operations, lock-free programming, async I/O | 25-30 | advanced | Planned |
4652
| 6 | [Performance Optimization](documents/vol6-performance/) -- CPU cache, SIMD, reading assembly, benchmarking | 18-22 | advanced | Planned |
4753
| 7 | [Software Engineering Practices](documents/vol7-engineering/) -- CMake, testing, static analysis, DevOps | 30-35 | intermediate | Planned |
4854
| 8 | [Domain Applications](documents/vol8-domains/) -- embedded / networking / GUI / data storage / algorithms | 80-100 | intermediate | In Progress |
55+
| 9 | [Open Source Project Study](documents/vol9-open-source-project-learn/) -- reading and analyzing open source codebases | 13+ | intermediate | In Progress |
4956
| - | [Compilation & Linking In Depth](documents/compilation/) -- preprocessing, assembly, linking, debug symbols | 10+ | intermediate | Completed |
5057
| - | [Capstone Projects](documents/projects/) -- hand-rolled STL, mini HTTP server, embedded OS | - | advanced | Planned |
5158

59+
</details>
60+
5261
---
5362

5463
## Learning Paths
5564

5665
```mermaid
5766
flowchart TD
5867
subgraph PathA["Path A -- C and Embedded Experience"]
59-
A1["Volume 2: Modern C++ Features"] --> A2["Volume 8: Embedded Development"]
68+
A1["Vol.2: Modern C++ Features"] --> A2["Vol.8: Embedded Development"]
6069
end
6170
subgraph PathB["Path B -- C++ Experience"]
62-
B1["Volume 8: Fundamentals Review"] --> B2["Platform Tutorials"] --> B3["RTOS Practice"]
71+
B1["Vol.8: Fundamentals Review"] --> B2["Platform Tutorials"] --> B3["RTOS Practice"]
6372
end
6473
subgraph PathC["Path C -- Both"]
6574
C1["Jump to any topic of interest"]
6675
end
6776
subgraph PathD["Path D -- Complete Beginner"]
68-
D1["Volume 1: C++ Fundamentals (incl. C crash course)"] --> D2["Volume 2: Modern C++ Features"]
77+
D1["Vol.1: C++ Fundamentals (incl. C crash course)"] --> D2["Vol.2: Modern C++ Features"]
6978
end
7079
Start(["Your starting point?"]) -->|"C + Embedded"| PathA
7180
Start -->|"C++ Experience"| PathB
@@ -112,30 +121,28 @@ cd Tutorial_AwesomeModernCPP
112121

113122
---
114123

115-
## Version History
124+
<details>
125+
<summary>Version history / Branches / Directory structure</summary>
126+
127+
**Version History**
116128

117129
| Version | Date | Notes |
118130
|------|------|------|
119131
| [v0.1.0](changelogs/v0.1.0.md) | 2026-04-29 | Initial public release -- Vol 1/2, compilation, and embedded tutorials |
120132

121133
See [changelogs/](changelogs/) for full release history.
122134

123-
---
124-
125-
## Branch Overview
135+
**Branch Overview**
126136

127137
| Branch | Purpose | Status |
128138
|------|------|------|
129139
| `main` | Primary development branch | Active |
130140
| `archive/legacy_20260415` | Pre-restructuring archive | Read-only |
131141
| `gh-pages` | Auto-deployed documentation site | Auto-generated |
132142

133-
---
143+
**Project Directory Structure**
134144

135-
<details>
136-
<summary>Project directory structure</summary>
137-
138-
```
145+
```text
139146
Tutorial_AwesomeModernCPP/
140147
├── documents/ # Tutorial Markdown files
141148
│ ├── vol1-fundamentals/ # Volume 1: C++ Fundamentals (ch00-ch12 + C crash course)
@@ -151,10 +158,13 @@ Tutorial_AwesomeModernCPP/
151158
│ │ ├── gui-graphics/ # GUI and Graphics
152159
│ │ ├── data-storage/ # Data Storage
153160
│ │ └── algorithms/ # Algorithms and Data Structures
161+
│ ├── vol9-open-source-project-learn/ # Volume 9: Open Source Project Study
154162
│ ├── compilation/ # Compilation & Linking In Depth
155163
│ ├── projects/ # Capstone Projects
156164
│ └── index.md # Tutorial home page
157165
├── code/ # Example code
166+
│ ├── volumn_codes/vol1/ # Volume 1 code and exercises
167+
│ └── examples/ # Legacy code examples
158168
├── scripts/ # Developer tool scripts
159169
├── todo/ # Content planning and progress tracking
160170
└── mkdocs.yml # MkDocs site configuration
@@ -189,11 +199,5 @@ This project references the following excellent resources:
189199

190200
- **License**: [MIT License](./LICENSE)
191201
- **Issues**: [Submit an issue](https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/issues)
192-
- **Email**: 725610365@qq.com
202+
- **Email**: <725610365@qq.com>
193203
- **Organization**: [Awesome-Embedded-Learning-Studio](https://github.com/Awesome-Embedded-Learning-Studio)
194-
195-
---
196-
197-
<p align="center">
198-
<b>Learn modern C++ systematically, from fundamentals to practice</b>
199-
</p>

README.md

Lines changed: 25 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,28 @@
22

33
[English](README.en.md) | 中文
44

5+
> 一套系统化的现代 C++ 教程 -- 从基础语法到嵌入式实战,每个概念配有可编译的代码示例
6+
7+
<p align="center">
8+
<a href="https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/">
9+
<img src="https://img.shields.io/badge/📖_在线阅读文档站-Live-blue?style=for-the-badge" alt="Online Docs">
10+
</a>
11+
</p>
12+
513
![C++](https://img.shields.io/badge/C%2B%2B-11%20%7C%2014%20%7C%2017%20%7C%2020%20%7C%2023-blue?logo=c%2B%2B)
614
![Release](https://img.shields.io/github/v/release/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
715
![License](https://img.shields.io/github/license/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
8-
![Stars](https://img.shields.io/github/stars/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
9-
![Issues](https://img.shields.io/github/issues/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP)
1016
![Build](https://img.shields.io/github/actions/workflow/status/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/deploy.yml?branch=main)
11-
[![Docs](https://img.shields.io/badge/docs-online-blue)](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/)
12-
13-
> 一套系统化的现代 C++ 教程 -- 从基础语法到嵌入式实战,从标准库深入到并发编程,每个概念配有可编译的代码示例
1417

1518
---
1619

1720
## 特色亮点
1821

19-
- **系统化学习路径** -- 9 卷从入门到高级,每卷有明确前置知识,循序渐进
20-
- **实战驱动** -- 每个概念配合可编译的 CMake 项目,而非孤立代码片段
21-
- **多平台覆盖** -- STM32 / ESP32 / RP2040 嵌入式实战,不止于桌面端
22-
- **标签导航** -- 按主题、C++ 标准、难度、平台等维度检索文章
23-
- **在线阅读** -- MkDocs 文档站,支持搜索与导航
22+
- **9 卷体系** -- 从 C 语言速通到嵌入式实战,形成完整学习闭环
23+
- **可编译示例** -- 每个概念配 CMake 工程,不是孤立的代码片段
24+
- **嵌入式实战** -- STM32 / ESP32 / RP2040 多平台真机项目
25+
- **标签导航** -- 按主题、C++ 标准、难度、平台多维检索
26+
- **在线阅读** -- 搜索、导航、暗色模式一应俱全的文档站
2427

2528
---
2629

@@ -36,7 +39,8 @@ graph LR
3639
V9 --> OC["Chrome 代码研读"] & OS["其他开源项目"]
3740
```
3841

39-
### 教程结构
42+
<details>
43+
<summary>各卷详细内容与进度</summary>
4044

4145
|| 主题 | 文章数 | 难度 | 状态 |
4246
|:--:|------|:------:|:----:|:----:|
@@ -52,6 +56,8 @@ graph LR
5256
| - | [编译与链接深入](documents/compilation/) -- 预处理、汇编、链接、调试符号 | 10+ | intermediate | 已完成 |
5357
| - | [贯穿式实战项目](documents/projects/) -- 手写 STL、迷你 HTTP 服务器、嵌入式 OS | - | advanced | 规划中 |
5458

59+
</details>
60+
5561
---
5662

5763
## 学习路径
@@ -115,30 +121,28 @@ cd Tutorial_AwesomeModernCPP
115121

116122
---
117123

118-
## 版本历史
124+
<details>
125+
<summary>版本历史 / 分支 / 目录结构</summary>
126+
127+
**版本历史**
119128

120129
| 版本 | 日期 | 说明 |
121130
|------|------|------|
122131
| [v0.1.0](changelogs/v0.1.0.md) | 2026-04-29 | 首个公开版本,卷一/卷二/编译卷/嵌入式教程 |
123132

124133
完整变更记录见 [changelogs/](changelogs/) 目录。
125134

126-
---
127-
128-
## 分支说明
135+
**分支说明**
129136

130137
| 分支 | 用途 | 状态 |
131138
|------|------|------|
132139
| `main` | 主开发分支 | Active |
133140
| `archive/legacy_20260415` | 重构前存档 | Read-only |
134141
| `gh-pages` | 自动部署的文档站 | Auto-generated |
135142

136-
---
143+
**项目目录结构**
137144

138-
<details>
139-
<summary>项目目录结构</summary>
140-
141-
```
145+
```text
142146
Tutorial_AwesomeModernCPP/
143147
├── documents/ # 教程 Markdown 文件
144148
│ ├── vol1-fundamentals/ # 卷一:C++ 基础入门(ch00-ch12 + C 语言速通)
@@ -195,11 +199,5 @@ Tutorial_AwesomeModernCPP/
195199

196200
- **许可证**[MIT License](./LICENSE)
197201
- **Issues**[提交问题](https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP/issues)
198-
- **Email**725610365@qq.com
202+
- **Email**<725610365@qq.com>
199203
- **组织**[Awesome-Embedded-Learning-Studio](https://github.com/Awesome-Embedded-Learning-Studio)
200-
201-
---
202-
203-
<p align="center">
204-
<b>系统化学习现代 C++,从基础到实战</b>
205-
</p>

documents/index.en.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,14 @@ Practical applications of modern C++ across domains: embedded development, netwo
8686

8787
---
8888

89+
### Volume 9: Open Source Project Study
90+
91+
Learn industrial-grade C++ design and implementation by analyzing real open source codebases (e.g., Chromium).
92+
93+
- [Start Reading](vol9-open-source-project-learn/index.md)
94+
95+
---
96+
8997
### Compilation & Linking In-Depth
9098

9199
Deep exploration of C/C++ compilation, linking, static libraries, dynamic libraries, symbol visibility, and related core concepts. 10 articles in total.

mkdocs.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ site_author: Charliechen # 作者名称,可以改成你的真实姓名或网名
44
site_url: https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/
55

66
# 版权信息,显示在页面底部
7-
copyright: Copyright &copy; 2025 Charliechen - 保留所有权利
7+
copyright: Copyright &copy; 2025-2026 Charliechen - 保留所有权利
88

99
# 文档源文件夹
1010
docs_dir: "documents"
@@ -208,6 +208,7 @@ plugins:
208208
卷六 · 性能优化: Vol.6 - Performance
209209
卷七 · 工程实践: Vol.7 - Engineering
210210
卷八 · 领域应用: Vol.8 - Domains
211+
卷九 · 开源项目学习: Vol.9 - Open Source Projects
211212
编译与链接: Compilation & Linking
212213
实战项目: Projects
213214
标签: Tags

0 commit comments

Comments
 (0)