3 ms·
Most Python modules follow Pythons lead on the documentation front, look at Django for example if you want to compare apples and apples, http://docs.djangoproje
by pmorici 16y ago
Most Python modules follow Pythons lead on the documentation front, look at Django for example if you want to compare apples and apples, http://docs.djangoproject.com/en/1.2/ http://docs.djangoproject.com/en/1.2/
The documentation for Ruby itself doesn't appear to be much different then Rails, http://www.ruby-doc.org/stdlib/ http://www.ruby-doc.org/stdlib/ difficult to read and follow.
I've never needed a "cookbook" for Python, because the ingredients are clearly labeled and arranged and I'm already an experienced chef.
- slillibri 16y agoThe ruby stdlib seems to follow a different documentation format then everything else ruby. Look to http://www.ruby-doc.org/core http://www.ruby-doc.org/core for what is the standard documentation format (not that I like it much better).
- catch23 16y agoThat format comes from smalltalk. Ruby inherits lots of their ideology from smalltalk so it's no surprise to see them adopt their class browser either. However, I'm not sure if class browsers can be considered "documentation".