made readme more clear and added http documentation