docs: group the sidebar with toctree captions

Makefile

@@ -229,7 +229,7 @@ security:
 	@echo "$(GREEN)Security audit completed!$(NC)"
 
 # Install the dependencies needed to build the documentation (Sphinx + MyST +
-# Furo + extensions, listed in docs/requirements.txt). Also installs the
+# the Read the Docs theme + extensions, listed in docs/requirements.txt). Also installs the
 # package itself in editable mode so autodoc can import it.
 .PHONY: install-docs
 install-docs:

docs/api/index.md

@@ -1,7 +1,8 @@
 # API Reference
 
 Every public class, method and helper PyMemoryEditor exposes. For
-task-oriented walkthroughs, see the [User Guide](../guide/index.md).
+task-oriented walkthroughs, start at
+[Opening a process](../guide/opening-process.md).
 
 ## At a glance
 
@@ -20,14 +21,27 @@ task-oriented walkthroughs, see the [User Guide](../guide/index.md).
 
 ```{toctree}
 :maxdepth: 1
+:caption: The Entry Point
 
 openprocess
 enums
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Objects You Get Back
+
 memory-region
 remote-pointer
 pointer-path
 module-info
 thread-info
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Errors and Helpers
+
 errors
 utilities
 ```

docs/index.md

@@ -31,7 +31,8 @@ scans, freezing values) to a small, friendly API that works **identically on
 Windows, Linux and macOS**.
 
 Get going with the [Installation](installation.md) and [Quick Start](quickstart.md)
-pages, then dig into the [User Guide](guide/index.md) for the in-depth walkthroughs.
+pages, then work through the guide itself, starting at
+[Opening a process](guide/opening-process.md).
 Prefer to click rather than type? The bundled [GUI app](app.md) gives you a
 Cheat Engine-style interface for free.
 
@@ -100,48 +101,87 @@ explore, scan and freeze values by clicking.
 </tr>
 </table>
 
-## User's Guide
+## Documentation
 
-This part of the documentation walks you through every workflow, from opening a
-process to following multi-level pointer chains, plus the bundled GUI app.
+Every workflow is covered, from opening a process to following multi-level
+pointer chains — plus the bundled GUI app, the MCP server for AI assistants,
+and the reference for every public symbol. Each group below stands on its own,
+so you can start wherever your question is.
 
 ```{toctree}
-:maxdepth: 2
+:maxdepth: 1
+:caption: Getting Started
 
 why
 installation
 quickstart
-guide/index
-app
-mcp
 ```
 
-## API Reference
+```{toctree}
+:maxdepth: 1
+:caption: Core Workflow
 
-If you are looking for information on a specific class, method or parameter,
-this part of the documentation is for you.
+guide/opening-process
+guide/read-write
+guide/searching
+guide/pattern-scan
+```
 
 ```{toctree}
-:maxdepth: 2
+:maxdepth: 1
+:caption: Inspecting the Process
 
-api/index
+guide/memory-regions
+guide/modules-threads
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Pointers
+
+guide/pointers
+guide/pointer-scan
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Memory Allocation
+
+guide/allocate-free
 ```
 
-## Additional Notes
+```{toctree}
+:maxdepth: 1
+:caption: Tools
 
-Platform-specific behaviour, troubleshooting, logging, a glossary of the terms
-used throughout these docs, plus how to contribute and the project's license.
+app
+mcp
+```
+
+```{toctree}
+:maxdepth: 2
+:caption: API Reference
+
+api/index
+```
 
 ```{toctree}
 :maxdepth: 1
+:caption: Additional Notes
 
 platform-notes
 troubleshooting
 guide/logging
+glossary
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Project
+
 contributing
 funding
 license
-glossary
 ```
 
 ## Project links

docs/installation.md

@@ -18,7 +18,7 @@ any platform.
 pip install PyMemoryEditor
 ```
 
-## Install with the bundled GUI app
+## Install with the bundled GUI (`app`)
 
 The library ships an optional Cheat Engine-style GUI built on **PySide6
 (Qt for Python)**. To install it, use the `app` extra: