update docs with filter compatibility notes