New Rails documentation site
rails-doc.org
rails-doc.org
It could be neat, you could even have the app merge user submitted comments or changes to documentation (submitted via the web-app) back into the code documentation in the repository. Maybe set a convention where you create a DocApp folder for pages, all synced with the online webapp.
I hope this is what Nodata is working towards.
One issue is in making sure that as the API changes you can still correctly associate past comments to API where still appropriate.
(The auto-svn c/o is in place at least ...)
Not a fan of automatically merging comments back into the source code though. Better to just have someone sensible update the docs when needed and submit a patch.
I'm truly confounded why he hasn't done this.
This looks like a giant step forward for train-kind. Looking forward to using it a lot.