Drafted some general API documentation
Merge pull request #28 from JuliaLang/in/api_doc

Drafted some general API documentation