restructure headings

doc/dev/release-process.rst

@@ -1,6 +1,5 @@
-***************
 Release process
-***************
+===============
 
 * Update authors file
 * Update changelog

doc/dev/todo.rst

@@ -1,6 +1,5 @@
-****
 TODO
-****
+====
 
 Open points and issues of the project are tracked in the GitHub issues.
 Some annotations still remain in the code and should be moved over time

doc/index.rst

@@ -9,16 +9,22 @@
 Content
 #######
 
+User Documentation
+==================
+
 .. toctree::
    :maxdepth: 1
    :caption: User Documentation
 
-   user/installation
-   user/methods
-   user/printers
-   user/raspi
-   user/usage
-   user/barcode
+   user/installation.rst
+   user/methods.rst
+   user/printers.rst
+   user/raspi.rst
+   user/usage.rst
+   user/barcode.rst
+
+Printer profiles
+================
 
 .. toctree::
    :maxdepth: 1
@@ -28,30 +34,36 @@ Content
    printer_profiles/available-profiles.rst
    printer_profiles/available-encodings.rst
 
+Developer Documentation
+=======================
+
 .. toctree::
    :maxdepth: 1
    :caption: Developer Documentation
 
-   dev/release-process
-   dev/contributing
-   dev/changelog
-   dev/todo
+   dev/release-process.rst
+   dev/contributing.rst
+   dev/changelog.rst
+   dev/todo.rst
+
+API Documentation
+=================
 
 .. toctree::
    :maxdepth: 1
    :caption: API Documentation
 
-   api/escpos
-   api/printer
-   api/constants
-   api/exceptions
-   api/capabilities
-   api/config
-   api/image
-   api/cli
-   api/magicencode
-   api/codepages
-   api/katakana
+   api/escpos.rst
+   api/printer.rst
+   api/constants.rst
+   api/exceptions.rst
+   api/capabilities.rst
+   api/config.rst
+   api/image.rst
+   api/cli.rst
+   api/magicencode.rst
+   api/codepages.rst
+   api/katakana.rst
 
 ##################
 Indices and tables

doc/user/barcode.rst

@@ -1,5 +1,6 @@
 Printing Barcodes
 -----------------
+
 :Last Reviewed: 2023-05-16
 
 Many printers implement barcode printing natively.

doc/user/installation.rst

@@ -1,6 +1,5 @@
-************
 Installation
-************
+============
 
 :Last Reviewed: 2016-07-23
 

doc/user/methods.rst

@@ -1,6 +1,6 @@
-*******
 Methods
-*******
+=======
+
 :Last Reviewed: 2017-01-25
 
 Escpos class

doc/user/printers.rst

@@ -1,6 +1,6 @@
-********
 Printers
-********
+========
+
 :Last Reviewed: 2022-11-25
 
 As of now there are 7 different type of printer implementations.

doc/user/raspi.rst

@@ -1,6 +1,5 @@
-************
 Raspberry Pi
-************
+============
 
 :Last Reviewed: 2017-01-05
 

doc/user/usage.rst

@@ -1,6 +1,6 @@
-*****
 Usage
-*****
+=====
+
 :Last Reviewed: 2017-06-10
 
 Define your printer