docs: Revise docstring style

[Aleksander-Karlsson]

Description

Include a description of the change done Remove old rst/sphinx related tables that were largely unnecessary. Make documentation have a consistent style.

Why

The motivation for the change (if applicable) Less bloat distracting from the useful bits.

How

How the change is implemented (if it's not self evident in the diff) Manually 🥵

Checklist:

Before submitting this PR, please make sure:

• [x] I am complying with the contributing doc
• [x] My code builds clean without any errors or warnings
• [x] I have added/extended tests that prove my fix is effective or that my feature works
• [x] I have made corresponding changes to the documentation, and it builds correctly