Open Paebbels opened 4 years ago
I also saw:
Here is the intermediate state with a draft: https://paebbels-pydecor.readthedocs.io/en/paebbels-new-doc-theme/
If you like the direction, please give a go, and I'll go on otherwise I'll stop it here.
@mplanchard have you had time to look at my proposed new documentation layout? (see comment above)
The default theme used by Sphinx is not very suitable for longer or detailed documentations.
I suggest switching to the ReadTheDocs theme. It looks like this:
Source: https://pyterminalui.readthedocs.io/en/latest/index.html
In bigger examples is becomes like this:
Source: https://ghdl.readthedocs.io/en/latest/getting/index.html
Here is an updated
conf.py
. Lately, Sphinx get rid of unused parameters in the config file. So when you start the Sphinx wizard nowadays, it's a tiny file.