actual API documentation
nits
learning markdown
????
Merge pull request #1021 from eshellman/develop

attempted some api documentation... it's a start.