update docs to reflect 1.8.7 compat