updating readme and simplifying response classes to not require @see
tags