Maybe a can try give some suggestions.
> I don't know if anything can be done to improve, maybe you can show us how to debug these
> r. and like objects and find out which object responds to what on a basic
> level for someone who doesn't really understand much of metaprogramming.
I think you have to do this youself, there is a gem name `looksee` can help on this a lot i think.
> I'm also not sure if something can be done to improve the documentation,
> but I'm open to suggestions.
I consider `programming roda` is a nice book for beginning roda user, sure it can answer question like this.
For a more deeper reading, i thought comment in plugin is very well too.