This PR updates the api documentation to reflect 0.6 HTTP API and the JSON job specification as well.