add docs for 1.8.7 deprecation