Merge pull request #341 from alex/backwards-compat

Document our API stability policy. Fixes #312