I think improving the online documentation is a good idea.

How can this effort avoid merely addressing subjective preferences? Beauty in the eye of the beholder, and all that.

This appears to be the current style guide:

It largely focuses on content. Would it be worth codifying additional aesthetic and usability objectives, and build consensus around them?

Are there other sites that have refreshed their styles we can learn from? For example, Wikipedia did a refresh last year.


On Mon, 2021-05-03 at 13:57 +0400, Abdur-Rahmaan Janhangeer wrote:
Time from someone clever with CSS in Sphinx may be all it takes.

Yes, agree 👍, i am not suggesting other
docs systems but just reconsidering the style.

@Marc indeed raised the question of overall
consistency which i guess will be addressed one 
day or the other. As for the wiki besides, look
there are many, many issues in terms of outdated
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-leave@python.org
Message archived at https://mail.python.org/archives/list/python-ideas@python.org/message/WLKNFY52PSOQFK5TKPI2APTLDVLO3RSH/
Code of Conduct: http://python.org/psf/codeofconduct/