improve filter docs