Update the usage documentation

Author: wu-clan

docs/explanation.md

@@ -1 +1,25 @@
-TODO...
+!!! note
+
+    - `开发者` 指使用JustAuth的开发者
+    - `第三方` 指开发者对接的第三方客户端，比如：Google、GitHub、Gitee 等
+    - `用户` 指最终服务的真实用户
+
+- ==client_id== 客户端身份标识符（应用id），一般在申请完 `OAuth` 应用后，由第三方客户端颁发
+- ==client_secret== 客户端密钥，一般在申请完 `OAuth` 应用后，由第三方客户端颁发
+- ==redirect_uri== 开发者项目中真实有效的 API 地址。用户在确认第三方客户端授权（登录）后，第三方客户端会自动重定向到该地址，并携带
+  code 等参数
+- ==state== 用于在请求和回调之间维护状态，主要用于防止跨站请求伪造（CSRF）攻击
+- ==source== 支持的第三方客户端，比如：GitHub、LinuxDo 等
+- ==sid== 第三方客户端的用户 ID。以下是关于各平台的 sid 存储逻辑：
+
+!!! warning
+
+    建议通过 `sid` + `source` 的方式确定唯一用户，这样可以解决用户身份归属的问题。因为 单个用户ID
+    在某一平台中是唯一的，但不能保证在所有平台中都是唯一的。
+
+## 参考资料
+
+关于 OAuth2 相关的内容、原理可以自行参阅以下资料：
+
+- [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749)
+- [OAuth 2.0](https://oauth.net/2/)

docs/install.md

@@ -7,20 +7,20 @@
 
 ## 安装
 
-=== ":simple-piped: pip"
+=== ":simple-python: pip"
 
     ```sh
     pip install fastapi-oauth20
     ```
 
-=== ":simple-pdm: pdm"
+=== ":simple-uv: uv"
 
     ```sh
-    pdm add fastapi-oauth20
+    uv add fastapi-oauth20
     ```
 
-=== ":simple-uv: uv"
+=== ":simple-pdm: pdm"
 
     ```sh
-    uv add fastapi-oauth20
+    pdm add fastapi-oauth20
     ```

docs/integration.md

@@ -1,7 +1,13 @@
-如果你有更多需求，请在仓库内创建 Issues，我们将尽力完成所有目标
+!!! tip
 
-- [x] 表示已集成
-- [ ] 表示待集成
+    如果你有更多需求，请在仓库内创建 Issues，我们将尽力完成所有目标
+    
+    !!! danger ""
+
+        对于强制要求【实名 + 人脸认证】的平台，集成变得困难，所以它们不会很快到来
+
+    - [x] 表示{++已集成++}
+    - [ ] 表示{--未集成--}
 
 ---
 

mkdocs.yml

@@ -6,14 +6,13 @@ site_author: Wu Clan
 repo_name: fastapi-oauth20
 repo_url: https://github.com/wu-clan/fastapi-oauth20
 nav:
-  - Home:
-      - 主页: index.md
-      - 集成状态: integration.md
-  - Install: install.md
-  - Explanation: explanation.md
-  - Usage: usage.md
-  - Advanced: advanced.md
-  - Changelog: changelog.md
+  - 主页: index.md
+  - 集成状态: integration.md
+  - 安装: install.md
+  - 名词解释: explanation.md
+  - 用法: usage.md
+  - 高级用法: advanced.md
+  - 变更日志: changelog.md
 theme:
   name: material
   font:
@@ -42,7 +41,6 @@ theme:
     - navigation.instant.progress
     - navigation.path
     - navigation.tracking
-    - navigation.tabs
     - navigation.tabs.sticky
     - navigation.top
     - navigation.footer
@@ -58,9 +56,16 @@ markdown_extensions:
   - attr_list
   - def_list
   - md_in_html
-  - pymdownx.snippets
+  - admonition
+  - pymdownx.details
   - pymdownx.superfences
+  - pymdownx.snippets
   - pymdownx.inlinehilite
+  - pymdownx.critic
+  - pymdownx.caret
+  - pymdownx.keys
+  - pymdownx.mark
+  - pymdownx.tilde
   - pymdownx.highlight:
       anchor_linenums: true
       line_spans: __span