improved docs for filter