Docs for history service + api

[sascala]

Description

Urgency

• Blocker
• High
• Medium

Requirements

• Test all commands and procedures.
• Build content locally and test for formatting/links.
• Add redirects to dcos-website/redirect-files.
• Change all affected versions (e.g. 1.7, 1.8, and 1.9).
• See the contribution guidelines.

[sascala]

@amitaekbote It looks like your team is responsible for the history service -- if that's correct, would you mind giving this a quick look over to make sure it's correct? I took the information from here: https://github.com/dcos/dcos/tree/master/packages/dcos-history/extra

And you can view the rendered swagger by pasting the file into http://editor.swagger.io.

[karlkfi]

Is it worth putting this in without a page to display it on? or should we just get it upstreamed to the dcos repo first?

[sascala]

@karlkfi my plan is to get the API checked out while I figure out where the best place is for the accompanying document.

[amitaekbote]

this looks good to me 🚢

[sascala]

@pavisandhu this is swagger for the history service, which couldn't be documented at the time of creation. Amita is the authority.