📝 update doc

nonebot/adapters/ding/__init__.py

@@ -5,8 +5,7 @@
 协议详情请看: `钉钉文档`_
 
 .. _钉钉文档:
-    https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p/
-
+    https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p
 """
 
 from .utils import log

nonebot/adapters/ding/event.py

@@ -12,7 +12,7 @@ from .message import Message
 
 class Event(BaseEvent):
     """
-    钉钉 协议 Event 适配。各事件字段参考 `钉钉文档`_
+    钉钉协议事件。各事件字段参考 `钉钉文档`_
 
     .. _钉钉文档:
         https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p
@@ -68,6 +68,7 @@ class ConversationType(str, Enum):
 
 
 class MessageEvent(Event):
+    """消息事件"""
     msgtype: str
     text: TextMessage
     msgId: str
@@ -126,12 +127,14 @@ class MessageEvent(Event):
 
 
 class PrivateMessageEvent(MessageEvent):
+    """私聊消息事件"""
     chatbotCorpId: str
     senderStaffId: Optional[str]
     conversationType: ConversationType = ConversationType.private
 
 
 class GroupMessageEvent(MessageEvent):
+    """群消息事件"""
     atUsers: List[AtUsersItem]
     conversationType: ConversationType = ConversationType.group
     conversationTitle: str

nonebot/adapters/ding/message.py

@@ -36,28 +36,32 @@ class MessageSegment(BaseMessageSegment):
 
     @staticmethod
     def atAll() -> "MessageSegment":
+        """@全体"""
         return MessageSegment("at", {"isAtAll": True})
 
     @staticmethod
     def atMobiles(*mobileNumber: str) -> "MessageSegment":
+        """@指定手机号人员"""
         return MessageSegment("at", {"atMobiles": list(mobileNumber)})
 
     @staticmethod
     def text(text: str) -> "MessageSegment":
+        """发送 ``text`` 类型消息"""
         return MessageSegment("text", {"content": text})
 
     @staticmethod
     def image(picURL: str) -> "MessageSegment":
+        """发送 ``image`` 类型消息"""
         return MessageSegment("image", {"picURL": picURL})
 
     @staticmethod
     def extension(dict_: dict) -> "MessageSegment":
-        """"标记 text 文本的 extension 属性，需要与 text 消息段相加。
-        """
+        """"标记 text 文本的 extension 属性，需要与 text 消息段相加。"""
         return MessageSegment("extension", dict_)
 
     @staticmethod
     def markdown(title: str, text: str) -> "MessageSegment":
+        """发送 ``markdown`` 类型消息"""
         return MessageSegment(
             "markdown",
             {
@@ -69,6 +73,7 @@ class MessageSegment(BaseMessageSegment):
     @staticmethod
     def actionCardSingleBtn(title: str, text: str, singleTitle: str,
                             singleURL) -> "MessageSegment":
+        """发送 ``actionCardSingleBtn`` 类型消息"""
         return MessageSegment(
             "actionCard", {
                 "title": title,
@@ -86,10 +91,11 @@ class MessageSegment(BaseMessageSegment):
         btnOrientation: str = '1',
     ) -> "MessageSegment":
         """
+        发送 ``actionCardMultiBtn`` 类型消息
+
         :参数:
 
             * ``btnOrientation``: 0：按钮竖直排列 1：按钮横向排列
-
             * ``btns``: [{ "title": title, "actionURL": actionURL }, ...]
         """
         return MessageSegment(
@@ -104,6 +110,8 @@ class MessageSegment(BaseMessageSegment):
     @staticmethod
     def feedCard(links: list) -> "MessageSegment":
         """
+        发送 ``feedCard`` 类型消息
+
         :参数:
 
             * ``links``: [{ "title": xxx, "messageURL": xxx, "picURL": xxx }, ...]