Greetings,

Interesting, i don't remember getting answers from you
all this time i was posting to this list

Normally you'd expect Mr Chris quipping along these lines:
"Well you can have your *own* version of the docs locally,
just do this and that" or the 'regular' folks posting

> Great softwares are not 
distinguished by docs crankiness and
unpleasantness. 

That was intended to be humourous but if it hurts, i'm
sorry, next time posting i'll be sure to write a page-full of
respectful content. I withdraw my mail above and rephrase
it below:

Greetings list,

I have been reading the Python docs since long.
I have enjoyed it, it has great pieces of information.
You have how-tos, faqs etc. Really awesome to read.

However, I feel that the style is a bit bland and off putting
for newcomers. I suggest we consider changing the theme
to a crisper and cleaner look. I find docs such as Masonite
really enjoyable to read: https://docs.masoniteproject.com/

I do hope we can advance something along these lines.


Kind Regards,

Abdur-Rahmaan Janhangeer
github
Mauritius


On Fri, Apr 30, 2021 at 10:34 AM Paul Bryan <pbryan@anode.ca> wrote:
A recipe to have an idea be marginalized or ignored:

1. Start by denigrating the work of others with pejoratives like "cranky" and "unpleasant".
2. Do not provide any support to back such a claim, or call out any specific usability issue. 
3. Imply that the content is deficient, without qualification.
4. Point to something that you just seem to like better, without comparison.
5. (Probably) expect others to implement your idea. Your work here is done.

Paul

On Fri, 2021-04-30 at 10:06 +0400, Abdur-Rahmaan Janhangeer wrote:
Greetings,

A proposal to change the theme of the 
Python docs. Great softwares are not 
distinguished by docs crankiness and
unpleasantness. 

Though what's more important is the 
content, nevertheless it can be made 
more enjoyable to read.

The Masonite docs for example is quite
nice: 
https://docs.masoniteproject.com/

Kind Regards,

Abdur-Rahmaan Janhangeer
github
Mauritius
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-leave@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/TMK7ROBHGDFBPHXID7R3FAD23VSGK7FH/
Code of Conduct: http://python.org/psf/codeofconduct/