freshen up docs for Batman.Request

Mostly reorganizing -- adding metadoc formatting, etc. Also, I learned that requests fire events when stuff happens. That should make #1024 easier to implement ... 

Also added `data` to the `Request::send` signature so it would be a bit more clear that it's meant to over ride `@get('data')`.