more work on getting started page of the API docs

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