In a recent api-sig meeting it was decided that we should link to this document as a good introduction and commentary on best practices. Change-Id: I662ed5c9c21a6eafb74cd1e224bf8c8953a556b6