chore: improve doc generation and test (#762)

Improve documentation generation and add tests for documentation.
Extend sphinx by todo directive.

The configuration table is now split into several tables. The test
is adapted accordingly.

There is a new test that checks the docstrings to be compliant to the
RST format as used by sphinx to create the documentation. We can not
use Markdown in docstrings. The docstrings are adapted accordingly.

An additional test checks that the documentation can be build with sphinx.
This test takes very long is only enabled in full run (aka. ci) mode.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

src/akkudoktoreos/optimization/genetic/geneticsolution.py

@@ -212,15 +212,14 @@ class GeneticSolution(ConfigMixin, GeneticParametersBaseModel):
             discharge_allowed (bool): Whether discharging is permitted.
 
         Returns:
-            tuple[BatteryOperationMode, float]:
-                A tuple containing:
+            tuple[BatteryOperationMode, float]: A tuple containing
                 - `BatteryOperationMode`: the representative high-level operation mode.
                 - `float`: the operation factor corresponding to the active signal.
 
         Notes:
             - The mapping prioritizes AC charge > DC charge > discharge.
             - Multiple strategies can produce the same low-level signals; this function
-            returns a representative mode based on a defined priority order.
+              returns a representative mode based on a defined priority order.
         """
         # (0,0,0) → Nothing allowed
         if ac_charge <= 0.0 and dc_charge <= 0.0 and not discharge_allowed: