docs: Majorly overhaul organization and format

docs/source/api.rst

@@ -0,0 +1,45 @@
+Additional API features
+=======================
+
+Sopel includes a number of additional functions that are useful for various
+common IRC tasks.
+
+Note that ``sopel.web`` was deprecated in 6.2.0, and is not included in this
+documentation, but is still in use in many modules. It's highly recommended
+that you switch to `requests <http://docs.python-requests.org/en/latest/>`_
+instead.
+
+.. contents::
+
+sopel.tools
+------------
+
+.. automodule:: sopel.tools
+   :members:
+
+sopel.tools.time
+----------------
+.. automodule:: sopel.tools.time
+   :members:
+
+sopel.tools.calculation
+-----------------------
+.. automodule:: sopel.tools.calculation
+   :members:
+
+sopel.tools.target
+------------------
+.. automodule:: sopel.tools.target
+   :members:
+
+sopel.tools.events
+------------------
+.. autoclass:: sopel.tools.events
+   :members:
+   :undoc-members:
+
+sopel.formatting
+-----------------
+.. automodule:: sopel.formatting
+   :members:
+   :undoc-members:

docs/source/bot.rst

@@ -1,4 +1,5 @@
-.. title:: The bot and its state
+The bot and its state
+=====================
 
 .. autoclass:: sopel.bot.Sopel
     :members:

docs/source/conf.py

@@ -28,7 +28,8 @@
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx']
+intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/source/config.rst

@@ -0,0 +1,20 @@
+Configuration functionality
+===========================
+
+.. automodule:: sopel.config
+   :members:
+   :undoc-members:
+
+
+.. automodule:: sopel.config.types
+   :members:
+   :undoc-members:
+
+The [core] configuration section
+--------------------------------
+
+.. autoclass:: sopel.config.core_section.CoreSection
+   :members:
+   :undoc-members:
+
+

docs/source/db.rst

@@ -0,0 +1,5 @@
+The bot's database
+==================
+
+.. automodule:: sopel.db
+   :members: