improve consistency of http::request return value
minor docs