Api doc extraction

@sam-github 
Put API into separate md file; some reorg of content in that file.