3 ms·
Why are you comparing a framework's documentation to a language docs? I would assume people using rails would already know ruby so it wouldn't make sense to ca
by catch23 16y ago
Why are you comparing a framework's documentation to a language docs? I would assume people using rails would already know ruby so it wouldn't make sense to categorize their documentation using some kind of arbitrary categorization. If you prefer docs on how "X" should be done, you should get a language/framework "cookbook".
- pmorici 16y agoMost 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".