diff --git a/README.md b/README.md
index 458a790e..af02c97c 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,43 @@
-# 🦝 CompletableFuture-Fu (CF-Fu)
+# 🦝 CompletableFuture Fu (CF-Fu)
-并发是一个复杂问题,业界有大量的工具、框架可以采用。
+
+
+如何管理并发执行 是一个复杂易错的问题,业界有大量的工具、框架可以采用。
其中[`CompletableFuture`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/CompletableFuture.html)有其优点:
- `Java`标准库内置
- 无需额外依赖,几乎总是可用
- 广为人知广泛使用,有一流的群众基础
+ - `CompletableFuture`的父接口[`Future`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/concurrent/Future.html)早在`Java 5`就有了
+ - 虽然`Future`不支持异步 获取结果与编排异步执行逻辑,但也让大众熟悉了`Future`的概念
- 相信有极高质量的实现
- 功能强大、但不会非常庞大复杂
+ - 足以应对日常的业务需求开发
- 像大型并发框架(如`AKKA`)使用上需要理解的内容要多很多
- 当然基本的并发关注方面的复杂性,与具体使用哪个工具无关,都是要理解与注意的
+`CompletableFuture`用于
+
+- 编排业务处理流程(或说串接业务处理任务)
+- 以并发的方式执行业务逻辑,从而提升业务响应性
+
值得更深入了解和应用。 💕
+--------------------------------------------------------------------------------
+
+
+
+
+- [🎯 目标](#-%E7%9B%AE%E6%A0%87)
+- [🐶 `CompletableFuture` Guide](#-completablefuture-guide)
+- [🔧 库功能](#-%E5%BA%93%E5%8A%9F%E8%83%BD)
+- [👋 关于库名](#-%E5%85%B3%E4%BA%8E%E5%BA%93%E5%90%8D)
+
+
+
+--------------------------------------------------------------------------------
+
## 🎯 目标
- 作为文档库:
@@ -26,9 +50,37 @@
- 期望在业务中,更方便自然地使用`CompletableFuture`
- 这部分只是甜点目标
+## 🐶 `CompletableFuture` Guide
+
+### 0. `CompletableFuture`的创建
+
+通过静态工厂方法(🏭)或构造函数(🅒)来创建`CompletableFuture`。这些方法
+
+| 方法名 | | 结果类型 | `Executor` | 备注 |
+|--------------------------------------------------------|-----|---------|-------------------|--------------------------------------------|
+| `CompletableFuture()` | 🅒 | 类型参数`T` | 无需 | 显式通过`CF`对象的写方法完成,无需`Executor`来运行 |
+| | | | | |
+| `completedFuture(U value)` | 🏭 | 类型参数`U` | 无需 | 用入参`value`构建一个已完成的`CF`,无需`Executor`来运行 |
+| `completedStage(U value)` | 🏭 | 类型参数`U` | 无需 | 与上一方法一样,只是返回的类型是`CompletionStage`而不`CF` |
+| `failedFuture(Throwable ex)` | 🏭 | 类型参数`U` | 无需 | 用入参`ex`构建一个已完成的`CF`,无需`Executor`来运行 |
+| `failedStage(Throwable ex)` | 🏭 | 类型参数`U` | 无需 | 与上一方法一样,只是返回的类型是`CompletionStage`而不`CF` |
+| | | | | |
+| `supplyAsync(Supplier supplier)` | 🏭 | 类型参数`U` | `CF`的缺省`Executor` | |
+| `supplyAsync(Supplier supplier, Executor executor)` | 🏭 | 类型参数`U` | `executor`参数 | |
+| `runAsync(Runnable runnable)` | 🏭 | `Void` | `CF`的缺省`Executor` | |
+| `runAsync(Runnable runnable, Executor executor)` | 🏭 | `Void` | `executor`参数 | |
+
+### 1. 流程编排
+
+`CompletableFuture`的处理流程编排涉及下面几个方面:
+
+- 输入输出的数据,aka. 参数类型与结果类型
+- 错误处理/报错反馈
+- `executor`指定
+
## 🔧 库功能
-**_`WIP...`_**
+**_WIP..._**
[`Cffu.java`](src/main/java/io/foldright/cffu/Cffu.java):