Merge pull request #115 from kjd/deprecation-policy

Adjust documentation (issue #18)