News for hackers. Stuff that matters.
Re:How a programming language documentation ought to look li... by Wilfred on Friday November 19, 2010 @06:15PM (#1923224)
Python's docs are reasonable, but could be better. I don't like the left-hand contents, I find it breaks the flow. Wikipedia's inline contents seem far more intuitive. I'd like to be able to jump to specific functions.

(Moving to bpython solved most of these problem though, as it shows the docstring for a given function inline.)

Also, you end up spending a lot of time reading the docs and so a little typographical polish wouldn't hurt. The page is simply too wide.

There are no comments on this comment yet.