3 ms·
What do people gain by writing ill informed, flame bait artictles? http://docs.python.org/ http://docs.python.org/ Official python docs are a class of its own
by irahul 15y ago
What do people gain by writing ill informed, flame bait artictles?
http://docs.python.org/ http://docs.python.org/
Official python docs are a class of its own - browse online, higher in google results, download static files, offline searching, well organized, curated content with a lot of example code etc etc.
http://ruby-doc.org/ http://ruby-doc.org/
Ruby docs don't even come close. I have been told ruby docs are mostly a volunteer effort and one man operation, and I mean no offence to whoever is the maintainer, but it isn't comparable to python's.
I haven't tried interactive python tutorial, but the official python tutorial is the best tutorial I have read.
http://docs.python.org/tutorial/index.html http://docs.python.org/tutorial/index.html
I program comfortably in a number of langauges, and have read a lot of code and documentation. If I have to choose top language tutorials among c, c++, java, perl, python, erlang, lua, javascript, c#, it will be a tie between python's and "Learning Perl".
https://docs.djangoproject.com/en/1.4/ https://docs.djangoproject.com/en/1.4/
Django's documentation is one click away from the landing page, and the link is located where it is expected to be. Are you seriously telling me you had a problem finding the docs or the download button(so called usability problem)?
FWIW, I find rails guide better than django docs, but that doesn't make the django docs unusable or bad.
http://guides.rubyonrails.org/ http://guides.rubyonrails.org/
http://ringce.com/hyde http://ringce.com/hyde Jekyll's counterpart is hyde. A simple google search for "python jekyll" would have told you that.
Comparing Google App Engine to Heroku or DHH's landing page Adrian's, and concluding Python is ugly is ridiculous. To be honest, I find the whole article ridiculous.
I have nothing against design and people making pretty shit. I just take exception to lame claims about a language's usability based on how pretty the landing page looks. And in the case of python docs and django tutorials, it doesn't even look bad, and is perfectly usable.