The docs folder structure seemed overly complicated and was hard to navigate, with too many empty index pages. I flattened the structure so that there are fewer pages and folders.
I also did the opposite for the API reference page (splitting it out into a folder) since it's very long, and the api/index page is a useful outline.
I don't think the Alabaster theme is very readable, so I switched Furo, which I think looks a lot nicer, and also has a dark mode.
I fixed a lot of bugs with missing documentation and enabled intersphinx links to the Python docs for stdlib types.
The docs folder structure seemed overly complicated and was hard to navigate, with too many empty index pages. I flattened the structure so that there are fewer pages and folders.
I also did the opposite for the API reference page (splitting it out into a folder) since it's very long, and the api/index page is a useful outline.
I don't think the Alabaster theme is very readable, so I switched Furo, which I think looks a lot nicer, and also has a dark mode.
I fixed a lot of bugs with missing documentation and enabled intersphinx links to the Python docs for stdlib types.