doc/main/index: Clarify categories.

This is more descriptive than just repeating the module name.
pybricks · Dec 16, 2022 · 1c5e390 · 1c5e390
1 parent 98e7d81
commit 1c5e390
Show file tree

Hide file tree

Showing 6 changed files with 12 additions and 9 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,9 @@
 
 ## Unreleased
 
+### Changed
+- Changed module TOC headings to make it easier to find things.
+
 ## 3.2.0c1 - 2022-12-09
 
 ### Changed

diff --git a/doc/main/hubs/index.rst b/doc/main/hubs/index.rst
@@ -1,7 +1,7 @@
 .. pybricks-requirements::
 
-:mod:`hubs <pybricks.hubs>` -- Programmable hubs
-================================================
+:mod:`hubs <pybricks.hubs>` -- Built-in hub functions
+=====================================================
 
 .. module:: pybricks.hubs
 

diff --git a/doc/main/iodevices/index.rst b/doc/main/iodevices/index.rst
@@ -1,6 +1,6 @@
 .. pybricks-requirements:: pybricks-iodevices
 
-:mod:`iodevices <pybricks.iodevices>` -- Generic I/O devices
+:mod:`iodevices <pybricks.iodevices>` -- Custom devices
 ============================================================
 
 .. module:: pybricks.iodevices
@@ -12,7 +12,7 @@
    pupdevice
    lwp3device
 
-This module has classes for generic input/output devices.
+This module has classes for generic and custom input/output devices.
 
 .. pybricks-classlink:: PUPDevice
 

diff --git a/doc/main/pupdevices/index.rst b/doc/main/pupdevices/index.rst
@@ -1,7 +1,7 @@
 .. pybricks-requirements::
 
-:mod:`pupdevices <pybricks.pupdevices>` -- Powered Up devices
-=============================================================
+:mod:`pupdevices <pybricks.pupdevices>` -- Motors, sensors, lights
+==================================================================
 
 .. automodule:: pybricks.pupdevices
     :no-members:

diff --git a/doc/main/robotics.rst b/doc/main/robotics.rst
@@ -1,7 +1,7 @@
 .. pybricks-requirements::
 
-:mod:`robotics <pybricks.robotics>` -- Robotics
-======================================================
+:mod:`robotics <pybricks.robotics>` -- Robotics and drive bases
+===============================================================
 
 .. automodule:: pybricks.robotics
     :no-members:

diff --git a/doc/main/tools/index.rst b/doc/main/tools/index.rst
@@ -1,6 +1,6 @@
 .. pybricks-requirements::
 
-:mod:`tools <pybricks.tools>` -- General purpose tools
+:mod:`tools <pybricks.tools>` -- Timing tools
 ========================================================
 
 .. automodule:: pybricks.tools