add some minor docs for filtering