[Python-ideas] Re: Changing The Theme of Python Docs Site

Greetings list, Created thread + summary: https://discuss.python.org/t/changing-the-theme-of-the-python-docs-styling/8621 Kind Regards, Abdur-Rahmaan Janhangeer about | blog github Mauritius

[Python-ideas] Re: Changing The Theme of Python Docs Site

On Sat, May 8, 2021 at 3:16 AM M.-A. Lemburg wrote: > > There's a new documentation WG dealing with documentation issues. Thanks — I hadn’t had a chance to point that out — but that’s where folks can contribute— kibitzing on this list is just a waste of time. > > I don't know whether styling a

[Python-ideas] Re: Changing The Theme of Python Docs Site

On 03.05.2021 11:57, 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

[Python-ideas] Re: Changing The Theme of Python Docs Site

Paul Bryan writes: > It largely focuses on content. Would it be worth codifying additional > aesthetic and usability objectives, and build consensus around > them? We're literally talking about painting a bikeshed! Just do it, and if people don't like it enough it gets rolled back. My two se

[Python-ideas] Re: Changing The Theme of Python Docs Site

I agree with the comment about removing full justification. Also, I think the Masonite docs' navigation is far superior to the Python docs. I like the full contents on the left, along with the version button, and the local jump on the right. The python docs require you to navigate somehwere e

[Python-ideas] Re: Changing The Theme of Python Docs Site

On Tue, May 4, 2021 at 11:05 PM Mike Miller wrote: > One thing that drives me nuts about the current Python docs > theme is > the FULL JUSTIFICATION that adds random spaces into each line to make > the > edges line > up! > > Whatever y'all do, please remove that.

[Python-ideas] Re: Changing The Theme of Python Docs Site

On 4/29/21 11:06 PM, Abdur-Rahmaan Janhangeer wrote: > Greetings, > > A proposal to change the theme of the > Python docs. The current docs theme is decent I think. Liked your link to the masonite docs theme slightly better, though not hugely different. However! One thing that drives me

[Python-ideas] Re: Changing The Theme of Python Docs Site

Greetings list, Julien Palard responded with the following: *Hi Abdur,> 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: htt

[Python-ideas] Re: Changing The Theme of Python Docs Site

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. Woul

[Python-ideas] Re: Changing The Theme of Python Docs Site

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

[Python-ideas] Re: Changing The Theme of Python Docs Site

On 30/04/2021 14:29, Rob Cliffe via Python-ideas wrote: On 30/04/2021 07:06, Abdur-Rahmaan Janhangeer wrote: The Masonite docs for example is quite nice: https://docs.masoniteproject.com/ I read as far as the 4th sentence:     "Use it for your next SaaS!"

[Python-ideas] Re: Changing The Theme of Python Docs Site

Yeah, the HOWTOs on the docs include the best explanations of Regex and bitwise operators (and probably other arcane concepts) that I've found anywhere on the Internet, and it would be great if they were themed in a way that felt equal to other great resources on the Internet. On Mon, 3 May 2021 0

[Python-ideas] Re: Changing The Theme of Python Docs Site

I can well imagine someone turning away from a language because the docs felt old or badly styled. One practical effect of it is people preferring to read articles on other sites rather than consult the docs first. One piece of docs that is greatly explained is the sockets section. The part i am

[Python-ideas] Re: Changing The Theme of Python Docs Site

As someone who does both Web design and Python regularly, I'd love to contribute to reworking/changing the Python docs theme. They are not terrible currently, there are certainly areas for improvement, both in overall layout and text styling. Bringing it closer to other Python branding may also be

[Python-ideas] Re: Changing The Theme of Python Docs Site

Found the link i was referring to: https://psg.com/r.clue.html quote: <> @Rob Cliffe I was saying that if you don't know the flashy terms it's an indication that you come from a great time. Me myself i find myself no longer wanting to go deep into networking or the Linux kernel maybe because i

[Python-ideas] Re: Changing The Theme of Python Docs Site

Woops i present my excuses list, it seems english jokes in my country don't play well overall. I never intend to insult people nor insinuate insults. @Rob Cliffe normally when i have old friends, i like to joke about how ancient they are. A dinosaur in tech deserves respect. Like i was reading th

[Python-ideas] Re: Changing The Theme of Python Docs Site

I recommend posters read the code-of-conduct at the foot of every email on this list. On Sun, May 2, 2021, 3:07 PM Abdur-Rahmaan Janhangeer wrote: > Greetings, > > I read as far as the 4th sentence: > "Use it for your next SaaS!" [no link atached] What on earth (I > wanted to use a stronge

[Python-ideas] Re: Changing The Theme of Python Docs Site

On Sun, 2021-05-02 at 23:07 +0400, Abdur-Rahmaan Janhangeer wrote: > Oh seems like you are a dinosaur needing some carbon dating. It seems you need to review the Python Community Code of Conduct: https://www.python.org/psf/conduct/ Please see the sections regarding being respectful and insults,

[Python-ideas] Re: Changing The Theme of Python Docs Site

On 02/05/2021 20:07, Abdur-Rahmaan Janhangeer wrote: Oh seems like you are a dinosaur needing some carbon dating. Thanks for the insult. Rob Cliffe ___ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-idea

[Python-ideas] Re: Changing The Theme of Python Docs Site

Greetings, I guess the difference is in a 'clean' look. I kind of find the docs as a reminder of some legacy software. The docs looks 'old' I know it's vague and subjective but maybe this rings with some more people. Kind Regards, Abdur-Rahmaan Janhangeer about

[Python-ideas] Re: Changing The Theme of Python Docs Site

Greetings, I read as far as the 4th sentence: "Use it for your next SaaS!" [no link atached] What on earth (I wanted to use a stronger expression) is an SaaS? I'd never heard of it. OK, Google told we what it stood for, but I don't feel any the wiser. Oh seems like you are a dinosaur needin

[Python-ideas] Re: Changing The Theme of Python Docs Site

Abdur-Rahmaan Janhangeer writes: > 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. Thank you! ;-) > However, I feel that the style is a bit bland and off putting > for newcomers. I

[Python-ideas] Re: Changing The Theme of Python Docs Site

On 30/04/2021 07:06, Abdur-Rahmaan Janhangeer wrote: The Masonite docs for example is quite nice: https://docs.masoniteproject.com/ I read as far as the 4th sentence:     "Use it for your next SaaS!" [no link atached] What on earth (I wanted to use a st

[Python-ideas] Re: Changing The Theme of Python Docs Site

Greetings, That was an upto the point, precise and deep answer. Seems a design agency (who are Python programmers themselves, else they miss a thing or two) might do a nice job. Maybe what's missing is a design code (set of rules for headers, links, buttons etc) Well i subscribed to d...@python.o

[Python-ideas] Re: Changing The Theme of Python Docs Site

Hi Abdur-Rahmaan, while I don't think our docs look particularly bad, freshening up the looks a bit every now and then certainly is something which should be considered to better show case the quality of the product "Python". In particular, it would make sense to bring the themes of the main www.

[Python-ideas] Re: Changing The Theme of Python Docs Site

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

[Python-ideas] Re: Changing The Theme of Python Docs Site

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 qualificat