update docs to use filters