Regen API docs, fix webhook docs, fix doc-building docs in README

Author: alanbriolat

README.rst

@@ -61,8 +61,9 @@ Of particular use is the "How to write plugins" section.
 
 You can build the documentation yourself with::
 
-    $ pip install sphinx
-    $ cd docs/
+    $ pip install -r requirements.docs.txt
+    $ cd doc/
+    $ ./regen_apidoc.sh
     $ make html
 
 Testing

doc/api/csbot.plugins.rst

@@ -5,6 +5,7 @@ Submodules
 ----------
 
 .. toctree::
+   :maxdepth: 4
 
    csbot.plugins.auth
    csbot.plugins.calc

doc/api/csbot.rst

@@ -5,13 +5,15 @@ Subpackages
 -----------
 
 .. toctree::
+   :maxdepth: 4
 
    csbot.plugins
 
 Submodules
 ----------
 
 .. toctree::
+   :maxdepth: 4
 
    csbot.cli
    csbot.config

src/csbot/plugins/github.py

@@ -103,7 +103,7 @@
 
 Module contents
 ===============
-"""
+"""  # noqa: E501
 import hmac
 import datetime
 import json

src/csbot/plugins/webhook.py

@@ -16,7 +16,7 @@ async def webhook(self, e):
 Configuration
 =============
 
-The following configuration options are supported in the ``[webserver]`` config section:
+The following configuration options are supported in the ``[webhook]`` config section:
 
 ==================  ===========
 Setting             Description