💡 add scheduler docstring

docs/.vuepress/config.js

@@ -76,6 +76,14 @@ module.exports = context => ({
                   title: "nonebot.typing 模块",
                   path: "typing"
                 },
+                {
+                  title: "nonebot.config 模块",
+                  path: "config"
+                },
+                {
+                  title: "nonebot.sched 模块",
+                  path: "sched"
+                },
                 {
                   title: "nonebot.log 模块",
                   path: "log"
@@ -83,10 +91,6 @@ module.exports = context => ({
                 {
                   title: "nonebot.exception 模块",
                   path: "exception"
-                },
-                {
-                  title: "nonebot.config 模块",
-                  path: "config"
                 }
               ]
             }

docs/api/README.md

@@ -10,7 +10,13 @@
     * [nonebot.typing](typing.html)
 
 
+    * [nonebot.config](config.html)
+
+
+    * [nonebot.sched](sched.html)
+
+
     * [nonebot.log](log.html)
 
 
-    * [nonebot.config](config.html)
+    * [nonebot.exception](exception.html)

docs/api/sched.md

@@ -0,0 +1,41 @@
+---
+contentSidebar: true
+sidebarDepth: 0
+---
+
+# NoneBot.sched 模块
+
+## 计划任务
+
+计划任务使用第三方库 [APScheduler](https://github.com/agronholm/apscheduler) ，使用文档请参考 [APScheduler使用文档](https://apscheduler.readthedocs.io/en/latest/) 。
+
+
+## `scheduler`
+
+
+* **类型**
+
+    `Optional[apscheduler.schedulers.asyncio.AsyncIOScheduler]`
+
+
+
+* **说明**
+
+    当可选依赖 `APScheduler` 未安装时，`scheduler` 为 None
+
+    使用 `pip install nonebot[scheduler]` 安装可选依赖
+
+
+
+* **常用示例**
+
+
+```python
+from nonebot import scheduler
+
+@scheduler.scheduled_job("cron", hour="*/2", id="xxx", args=[1], kwargs={arg2: 2})
+async def run_every_2_hour(arg1, arg2):
+    pass
+
+scheduler.add_job(run_every_day_from_program_start, "interval", days=1, id="xxx")
+```

docs/guide/installation.md

@@ -24,7 +24,7 @@ pip install .
 
 A task scheduling library for Python.
 
-可用于定时任务，后台执行任务等
+可用于计划任务，后台执行任务等
 
 ```bash
 pip install nonebot2[scheduler]

docs_build/README.rst

@@ -2,7 +2,9 @@ NoneBot Api Reference
 =====================
 
 :模块索引:
- - `nonebot <nonebot.html>`_
- - `nonebot.typing <typing.html>`_
- - `nonebot.log <log.html>`_
- - `nonebot.config <config.html>`_
+  - `nonebot <nonebot.html>`_
+  - `nonebot.typing <typing.html>`_
+  - `nonebot.config <config.html>`_
+  - `nonebot.sched <sched.html>`_
+  - `nonebot.log <log.html>`_
+  - `nonebot.exception <exception.html>`_

docs_build/sched.rst

@@ -0,0 +1,11 @@
+---
+contentSidebar: true
+sidebarDepth: 0
+---
+
+NoneBot.sched 模块
+===================
+
+.. automodule:: nonebot.sched
+   :members:
+   :show-inheritance:

nonebot/sched.py

@@ -1,5 +1,16 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+"""
+计划任务
+========
+
+计划任务使用第三方库 `APScheduler`_ ，使用文档请参考 `APScheduler使用文档`_ 。
+
+.. _APScheduler:
+    https://github.com/agronholm/apscheduler
+.. _APScheduler使用文档:
+    https://apscheduler.readthedocs.io/en/latest/
+"""
 
 try:
     from apscheduler.schedulers.asyncio import AsyncIOScheduler
@@ -8,5 +19,26 @@ except ImportError:
 
 if AsyncIOScheduler:
     scheduler = AsyncIOScheduler()
+    """
+    :类型:
+      ``Optional[apscheduler.schedulers.asyncio.AsyncIOScheduler]``
+    :说明:
+      当可选依赖 ``APScheduler`` 未安装时，``scheduler`` 为 None
+
+      使用 ``pip install nonebot[scheduler]`` 安装可选依赖
+
+    :常用示例:
+
+    .. code-block:: python
+
+        from nonebot import scheduler
+
+        @scheduler.scheduled_job("cron", hour="*/2", id="xxx", args=[1], kwargs={arg2: 2})
+        async def run_every_2_hour(arg1, arg2):
+            pass
+
+        scheduler.add_job(run_every_day_from_program_start, "interval", days=1, id="xxx")
+
+    """
 else:
     scheduler = None