added documentation for request objects