Live data from Hacker News

Python.org Redesign Preview

preview.python.org

131–140 of 165 posts

Re: Python.org Redesign Preview

#132

The problem with python's website was never that it wasnt "Sexy" enough to attract newcomers. Its that the documentation was never as well written or well organized as other languages/libraries like ruby and jQuery.

I find Python's online documentation to be fantastic. It's probably the best online documentation I use. I'm really curious what about it you find lacking.

Re: Python.org Redesign Preview

#133

A few misc. observations: * Too much of this page is spent on navigation and link lists. It's the landing page, but we don't need to link to every single sub-section of the site. * I don't think having a whole sub-menu on the bottom of the page with various download architectures is a good idea. A single "Downloads" link would be much better, breaking out by distro on the downloads page. * Ditto for a lot of the othe…

>Too much of this page is spent on navigation and link lists. It's the landing page, but we don't need to link to every single sub-section of the site.

aaaand the disagreement begins. I like debian.org's website /because/ it's a portal to the entire site.

Re: Python.org Redesign Preview

#134

Earlier quoted context omitted.

I'm not in any way related to this effort, but if you're going to give criticism, please at least make it constructive or give examples of what you mean. I certainly didn't find it horrible "in almost every way".

I think that was an example of very concise and constructive criticism. Sometimes just about everything is wrong with a given design, and saying so is the best way to express this. In this case, it's pretty obvious that the nav buttons are uselessly large, the empty padding on either end is wasteful and annoying, the location mid-way down the page isn't practical, the color makes it blend in with the page's backgroun…

It might be "constructive" if everyone is in basic agreement and people know what's being referred to. That's certainly not the case with the OP's comment, and there's obviously people who disagree. The specifics in your comment (especially your "In this case..." paragraph) are much more helpful and specific.

Re: Python.org Redesign Preview

#135
post #43

Earlier quoted context omitted.

Yeah, that example is a placeholder; we plan on replacing it with something awesome. Thanks!

Replace it with a try-python style interactive shell!

+1 for an interactive shell.

Something like http://repl.it/languages/Python :)

Re: Python.org Redesign Preview

#136
post #43

Earlier quoted context omitted.

Yeah, that example is a placeholder; we plan on replacing it with something awesome. Thanks!

Replace it with a try-python style interactive shell!

+1 to this. I was drawn to Code Academy because I could immediately start playing around with code on the home page. (At least it used to be like that. Not sure anymore.)

Re: Python.org Redesign Preview

#137

Looks nice, but my first thought when I looked at the code example: 1 >>> l = ['spam', 'ham', 314, 23] was "wait, how are they assigning a list to the number 1? How is that possible? Oh... that's an l". (Not a fan of that. I'm half blind (figuratively) so these things confuse me.)

Yeah, that example is a placeholder; we plan on replacing it with something awesome. Thanks!

The problem is using Courier, not the example. Try 'Monaco, Consolas, mono'

Re: Python.org Redesign Preview

#138
post #52

Earlier quoted context omitted.

Really? I've always found Python's documentation (especially the official tutorial) to be excellent. What do you think could be improved about it?

A navigable list of objects, functions, and methods would be really nice, something like this (preferably complete): http://api.rubyonrails.org Another suggestion would be to split tutorials/examples apart from object references. For example, take a peek at the Python Decimal module docs: http://docs.python.org/2/library/decimal.html#module-decimal All the information is there, but it isn't organized very well. There…

Agrees on this. Sometimes you don't want the tutorial or book, you just want the reference guide of one liners saying what the thing is, at least for the proficient programmer. If I come back to Python from a few months on some C++ project and have to spend 15 minutes looking up how to use their JSON api because I have to dig 90% of the time to find callables the docs fail.

The lack of a Javadoc / Qt ref / cppreference (I love that wiki) module / function list makes just searching for something you know exists and just need the method name a pain in the butt.

Re: Python.org Redesign Preview

#139
It doesn't go full-fullscreen on widescreen, which ususally isn't bad, but I know on the old python (and at least the docs site) having the vertical fixed sidebar list was handy, and much more useful than one horizontal navbar (or 3, in this case... maybe cut down on the nav bars).

Personal taste, I prefer my sites with a fixed vertical navigation pane to the side when you get ultra-widescreen.

Post reply on HN