finished first subsection of the api design section