added short design document and some additions to request class