From 178a9152514908994f464fbc20ad0b88c137ed4b Mon Sep 17 00:00:00 2001
From: Richard Chien <richardchienthebest@gmail.com>
Date: Thu, 18 Oct 2018 22:50:57 +0800
Subject: [PATCH] Update docs

---
 docs/glossary.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/docs/glossary.md b/docs/glossary.md
index 8b3ca7c1..a12dcc0a 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -109,3 +109,36 @@ Expression 可以是一个 `str`、元素类型是 `str` 的序列（一般为 `
 ## CQ 码
 
 是酷 Q 用来表示非文本消息的一种表示方法，形如 `[CQ:image,file=ABC.jpg]`。具体的格式规则，请参考酷 Q 文档的 [CQ 码](https://d.cqp.me/Pro/CQ%E7%A0%81) 和 CoolQ HTTP API 插件文档的 [CQ 码](https://cqhttp.cc/docs/#/CQCode)。
+
+## 消息段
+
+是 CoolQ HTTP API 定义的、和 CQ 码可以互相转换的一个消息表示格式，具体表示方式见 [消息格式](https://cqhttp.cc/docs/#/Message)。
+
+除了纯文本消息段之外，每一个消息段都和一个 CQ 码对应，例如下面这个消息段：
+
+```json
+{
+    "type": "face",
+    "data": {
+        "id": "14"
+    }
+}
+```
+
+对应的 CQ 码表示形式就是：
+
+```
+[CQ:face,id=14]
+```
+
+具体的，NoneBot 中使用 `MessageSegment` 类来表示消息段（继承自 aiocqhttp），例如，要创建上面这个消息段，可以使用如下代码：
+
+```python
+seg = MessageSegment(type="face", data={"id": "14"})
+```
+
+或：
+
+```python
+seg = MessageSegment.face(14)
+```