Deprecation guide

Draft guide to how we treat deprecation in the toolkit