- pushing new api description into code so we can comment on-line
initial description our workflow
- testing
Added header
- got rid of workflow, moved into new push on moc-api
- put in link to apidesc from top level readme, so we can link to all our
  internal documentation on github
incremental commit, still working on this
- think I am happy to have this reviewed now
Fixed a number of spelling/grammar issues.
Merge branch 'newapi' into devel