API Primer changes

I'll submit PRs on individual sections to break up the changes as I review the, documentation.