Good documentation is a key part

- Good summary of best practices for documentation: https://bocoup.com/weblog/documenting-your-api

- Tips for good api doc design: http://blog.parse.com/learn/engineering/designing-great-api-...