update the docs on filtering