I have revised READMEs for Action Pack, Active Record, Action Mailer and Active Support. The introductory text in the first two frameworks has gone through substaintial changes, and all 4 have copies of improved “download / installation / support” sections:
http://github.com/mislav/rails/compare/bcec0f65…doc-readmes
The motivation for this was noticing that both Action Pack and Active Record READMEs mention certain features/syntax that has been either deprecated or removed, that some link to inexisting API docs URLs, that all of them link to RubyForge as the place where we can find the latest versions of these frameworks, and that Action Pack and Active Record installation instructions suggest that the reader should install the 1.x versions of the gems. Also, Active Record documentation used a certain vocabulary that might be unfamiliar to both beginner and intermediate Ruby developer.
I haven’t pushed this to docrails yet. Apart from posting this to the docs mailing list, I’ve also posted to the core list to give all Rails Core members a chance to skim over these changes and see if they are OK. Here is an example; Action Pack download/installation instructions: http://gist.github.com/481333
Suggestions welcome. Thanks