True. What's really needed is some guidelines for getting things done
with erb/erubis/etc., rather than documentation, for the most part --
such as how to solve some common problems people might encounter
migrating from a PHP way of doing things to an erb way of doing things.
Greater visibility of certain documentation matters might be nice, too,
like all the default path and custom path definition stuff that goes on
when working with an erb implementation.
Perhaps then you're talking more about Rails and ActionPack (e.g. how
Rails locates a template, or how to factor code out into helper methods)
rather than Erb itself.
I found the book "Agile Web Development with Rails" to be extremely
good. Don't buy the 2nd edition - the 3rd edition for Rails 2.x is under
development. However you can buy the 3rd edition beta PDF now, and get
free updates until the final release.
Otherwise, the Rails API documentation is pretty comprehensive.
http://api.rubyonrails.com/
Click on actionpack/README in the top left box for an overview; then
click on ActionView::Base in the middle left box. (Unfortunately the
"Learn more" link under "Embedded Ruby for templates" appears to be
broken)
If you install Rails on your machine ("gem install -y rails"), then run
"gem server --daemon", you can point a web browser at
http://localhost:8808/ to browse the documentation off-line.
Good luck. However please bear in mind that this is a Ruby mailing list,
not a Rails mailing list. Rails, ActionFoo and ActiveBar questions would
best be directed elsewhere.