added details and articulated direction
added the first attempt at the API