I believe that given token of code should by stylized consistently throughout documentation to help the reader recognize the token amidst plain text. In many projects, this is not the case; for instance, in the documentation of scipy.stats.bootstrap, data appears as:
bold, monospaced, italicized with background
italicized
bold
pink, monospaced with gray background
Before noon on 6/3, I'd like to focus on resolving one source of these inconsistencies: numpy/numpydoc#525.
I believe that given token of code should by stylized consistently throughout documentation to help the reader recognize the token amidst plain text. In many projects, this is not the case; for instance, in the documentation of
scipy.stats.bootstrap,dataappears as:bold, monospaced, italicized with background
italicized
bold
pink, monospaced with gray background
Before noon on 6/3, I'd like to focus on resolving one source of these inconsistencies: numpy/numpydoc#525.