docs: update how to use (#10)

Author: King-sj

TODO.md

@@ -51,3 +51,4 @@
   - [ ] 将项目迁移到 C++20 模块系统，提升编译速度和模块化程度。
   - [ ] 确保与现有构建系统（如 CMake）的兼容性。
 
+- [ ] 解决 404 页面不能正确显示的问题

docs/source/contributing/architecture.md …s/source/contributing/01-architecture.mddocs/source/contributing/architecture.md renamed to docs/source/contributing/01-architecture.md docs/source/contributing/architecture.md renamed to docs/source/contributing/01-architecture.md

@@ -1,6 +1,6 @@
 # 快速上手
 
-本章节将指导你完成 `koroutine_lib` 的配置、构建，并编写你的第一个协程程序。
+本章节将指导你如何将 `koroutine_lib` 集成到你的项目中，并编写你的第一个协程程序。
 
 ## 1. 环境要求
 
@@ -11,34 +11,67 @@
 - **依赖库**:
   - **Linux**: `liburing` (用于异步 I/O)
 - **构建系统**: CMake 3.20+
-- **Python**: 用于文档生成 (可选)。
 
-## 2. 构建项目
+## 2. 集成方式 (推荐)
 
-```bash
-# 1. 克隆仓库
-git clone https://github.com/King-sj/koroutine_lib.git
-cd koroutine_lib
+我们推荐直接使用 Release 包中的预编译库和头文件进行集成。这种方式配置简单，编译速度快。
 
-# 2. 配置 CMake
-# -S . 指定源码根目录
-# -B build 指定构建输出目录
-cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
+### 目录结构
 
-# 3. 编译
-cmake --build build
+假设你下载并解压了 Release 包，目录结构如下：
+
+```text
+project_root/
+├── pkg/
+│   ├── include/        # 原始头文件
+│   ├── single_header/  # 单文件头文件 (推荐)
+│   └── lib/            # 静态库 (libkoroutinelib.a)
+├── src/
+│   └── main.cpp
+└── CMakeLists.txt
 ```
 
-编译成功后，你会在 `build/bin` 目录下找到所有的可执行文件（demos 和 tests）。
+### CMake 配置
+
+在你的 `CMakeLists.txt` 中添加以下配置：
+
+```cmake
+cmake_minimum_required(VERSION 3.20)
+project(my_app)
+
+set(CMAKE_CXX_STANDARD 23)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# 设置包路径
+set(PKG_DIR "${CMAKE_SOURCE_DIR}/pkg")
+
+# 包含头文件 (推荐使用 single_header)
+include_directories(${PKG_DIR}/single_header)
+
+# 链接库目录
+link_directories(${PKG_DIR}/lib)
+
+add_executable(my_app src/main.cpp)
+
+# 链接 koroutinelib
+# Linux 下通常还需要链接 pthread 和 dl
+target_link_libraries(my_app PRIVATE koroutinelib)
+if(UNIX AND NOT APPLE)
+    target_link_libraries(my_app PRIVATE pthread dl)
+endif()
+```
 
 ## 3. 你的第一个协程
 
 让我们编写一个简单的程序，它启动一个协程，异步地返回一个字符串。
 
 ```cpp
-#include "koroutine/koroutine.h"
+// 使用单文件头文件
+#include "koroutine.hpp"
 #include <iostream>
 
+using namespace koroutine;
+
 // 定义一个返回 std::string 的协程任务
 Task<std::string> get_greeting() {
     std::cout << "协程开始执行 on thread " << std::this_thread::get_id() << std::endl;
@@ -60,9 +93,7 @@ int main() {
 }
 ```
 
-将以上代码保存为 `my_first_coro.cpp`，并修改 `demos/CMakeLists.txt` 添加新的可执行目标，然后重新编译。
-
-运行它，你会看到类似以下的输出：
+编译并运行它，你会看到类似以下的输出：
 
 ```
 协程开始执行 on thread 0x16f787000
@@ -74,3 +105,4 @@ int main() {
 恭喜！你已经成功运行了你的第一个 `koroutine_lib` 程序。
 
 在下一章节，我们将深入探讨 `Task` 的更多用法。
+