ashander Make deprecation doc more useful