3 ms·
Compare that with this: http://ruby-doc.org/ruby-1.9/index.html http://ruby-doc.org/ruby-1.9/index.html I find that page (docs.python.org) easy to navigate usi
by wwortiz 16y ago
Compare that with this: http://ruby-doc.org/ruby-1.9/index.html http://ruby-doc.org/ruby-1.9/index.html
I find that page (docs.python.org) easy to navigate using the side menu and the structure of the document the fact that it is so big doesn't quite bother me, I already know most of what I need on that page and wouldn't be upset navigating it if I had to.
- michaelfairley 16y agoI in no way said that the python docs were worse than the ruby ones, only that the python docs are really not as great as they could be. You already knowing everything on the page doesn't make it any less poorly designed. I find it much more preferable to be able to search for "python string" on Google and be brought straight to a page about strings, not about every type in the languages (Ruby[1] and Java[2] both do this sanely.) The formatting within the python docs is also highly inconsistent. Why (on the built-in types page) do the operations on sequence types (5.6) get a nice table, but the operations on sets (5.7) have a poorly formatted list? [1] http://ruby-doc.org/core/classes/String.html http://ruby-doc.org/core/classes/String.html [2] http://cupi2.uniandes.edu.co/site/images/recursos/javadoc/j2se/1.5.0/docs/api/java/lang/String.html http://cupi2.uniandes.edu.co/site/images/recursos/javadoc/j2...
- jamesbritt 16y ago"Compare that with this: http://ruby-doc.org/ruby-1.9/index.html http://ruby-doc.org/ruby-1.9/index.html I have on my recklessly large to-do list plans to update the API docs on ruby-doc.org with YARD. The template seems a bit easier to navigate and the overall results better. But I'm always open to concrete suggestions. [note: I run ruby-doc.org]