Add monitor API docs.

- Document different monitor types.
- Document all available options for monitors, including downtime
  and scoped muting.
Fix up API endpoints for monitors.
Add a note about deprecation of the Alert API.
Shift location of monitor API docs
Add API docs for posting check runs
Merge pull request #243 from DataDog/conor/monitor-api

Add monitor API docs.