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 about <https://compileralchemy.github.io/> | blog <https://www.pythonkitchen.com> github <https://github.com/Abdur-RahmaanJ> Mauritius On Fri, Apr 30, 2021 at 10:34 AM Paul Bryan <pbr...@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 > about <https://compileralchemy.github.io/> | blog > <https://www.pythonkitchen.com> > github <https://github.com/Abdur-RahmaanJ> > Mauritius > _______________________________________________ > 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/TMK7ROBHGDFBPHXID7R3FAD23VSGK7FH/ > 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/U4ISS6PKQCZ2E5U2VYFSXJN4V6IWVXGV/ Code of Conduct: http://python.org/psf/codeofconduct/
