added api documentation
renamed the api to be markdown
merge conflict, we don't want this darwin lock file
darwin lock is now in gitignore