more work on the getting started section of the API docs

Signed-off-by: Daniel Newns <dan@higgsdesign.com>