Python.org Redesign Preview • Hacker News Board

Re: Python.org Redesign Preview

#161

Post by nayefc » Mon, Mar 18, 2013, 2:28 PM UTC

jacobian wrote: post #80

nayefc wrote: post #77

Finally! I really hope their docs improve because right now, they are horrendous.

Do you think you can clarify? Most people seem to think that Python's docs are quite good — it's one of the things that originally brought me to Python, along with many others. If you can explain how they let you down perhaps we can do something to fix it?

Sure. My main problem I find is actually finding what I need. Assume I want to read about the string split method. There are two places that I'd go to:

http://docs.python.org/2/library/string.html http://docs.python.org/2/library/stdtypes.html

I know the difference, but that's very confusing and annoying. It might be easier to have all string methods in one page, but separate them in terms of built-in standard library vs. the module ones.

Then I came across: http://docs.python.org/release/2.5.2/lib/string-methods.html which is a cleaner version.

Another thing I found in string a few days ago: the difference between capitalize() and title() on std string is not clarified at all in the docs.

Re: Python.org Redesign Preview

#162

Post by supervillain » Mon, Mar 18, 2013, 3:04 PM UTC

Looks and feels like ruby-lang.org

Just saying.

Re: Python.org Redesign Preview

#163

Post by brownbat » Mon, Mar 18, 2013, 4:20 PM UTC

caioariede wrote: post #135

reustle wrote: post #43

Earlier quoted context omitted.

Replace it with a try-python style interactive shell!

+1 for an interactive shell. Something like http://repl.it/languages/Python :)

Cool!

I got as far as:

  import os
  for filename in os.walk('/'):
    print(filename)

before realizing I should probably stop kicking stuff out of curiosity.

What are the dangers of dropping a python interpreter on a site, what are good guidelines to secure it?

Re: Python.org Redesign Preview

#164

Post by scott_karana » Mon, Mar 18, 2013, 7:33 PM UTC

I really like the design, personally. Well done!

Curious about the heading font used, FluxRegular.woff: does anybody know the source of the font, and the licensing? :)

Re: Python.org Redesign Preview

#165

Post by jodrellblank » Tue, Mar 19, 2013, 3:25 AM UTC

neutronicus wrote: post #101

disgruntledphd2 wrote: post #50

Earlier quoted context omitted.

I really liked Python's documentation. I read the tutorial and it got me up and running really quickly, and whenever I had a problem or needed details of the arguments it was an invaluable reference. Clearly, not everyone thought so. What did you not like about the docs?

It's nice to learn from, but if you already know what you're doing and you just forgot the arguments to that one god damn method, it's pretty irritating to actually find the arguments to that one god damn method.

>>> help(method)

usually tells you.