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:
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.
On Fri, Apr 30, 2021 at 10:34 AM Paul Bryan firstname.lastname@example.org wrote:
A recipe to have an idea be marginalized or ignored:
- 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.
On Fri, 2021-04-30 at 10:06 +0400, Abdur-Rahmaan Janhangeer wrote:
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/
Abdur-Rahmaan Janhangeer about https://compileralchemy.github.io/ | blog https://www.pythonkitchen.com github https://github.com/Abdur-RahmaanJ Mauritius _______________________________________________ Python-ideas mailing list -- email@example.com To unsubscribe send an email to firstname.lastname@example.org https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://email@example.com/message/TMK7RO... Code of Conduct: http://python.org/psf/codeofconduct/