documenting style and compatibility concerns
revisions based on review
Merge branch 'devguide-2.0' into mhrivnak-compatibility

Conflicts:
	docs/sphinx/dev-guide/policies/index.rst