On 26 April 2012 15:04, Scott Ribe <[email protected]> wrote: > Also, telling people who are trying to learn Rails and being blocked by > incomplete docs to write the docs themselves is really kind of silly ;-)
No this is the best thing to do. When you are experienced you tend to forget what you need to know and the entry will be terse and assume so many things. When a beginner documents something it will be just what another beginner will need, down to the "obvious" things that experienced programmers take for granted and assumes that everyone knows. Remember that an experienced programmer will probably skip the documentation and go straight for the source code, so as long as the source code exists then the documentation in perfect as far as an experienced programmer in concerned. What constitues good documentation depends on your needs. The OP is a beginner and therefore wants beginners documentation, as such the documentation written by another beginner would be ideal. -- You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/rubyonrails-talk?hl=en.

