added more documentation for request objects