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:
https://devguide.python.org/documenting/

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.

Paul


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
> content.
> _______________________________________________
> Python-ideas mailing list -- python-ideas@python.org
> To unsubscribe send an email to python-ideas-le...@python.org
> https://mail.python.org/mailman3/lists/python-ideas.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/

_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/QVBOKPU2KNEDRTMQEICR73MB6AYTVWFD/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to