Open fuglede opened 4 years ago
Thanks for the observation and comment, we will look into that.
I find that this is the default behavior of default theme readthedoc, so I am not sure whether it should be changed or not.
I'd prefer to change it, it is pretty confusing. The old SciPy Sphinx theme gets it right I think.
Quick test: In the screenshot below, there are code blocks of two colors, black and red. Out of these, which ones are links to other documentation pages, and which ones aren't?
I got it wrong myself: The black ones, which mostly fade in with the text, are links, but the red ones are not. Chances are that this is something that one will get used to quickly, but it might not be immediately apparent. Compare with the old documentation where all links are blue and clearly separated from the surrounding text. A solution could be to ensure that code links and non-code links have the same color.
On a separate note, the table in the screenshot seems to have some issues: The "Notes" column in the
tomaxint
row is formatted strangely. But, this is also the case in the old documentation, so this is probably just a case of markup not being done quite properly.