move filter documentation in with the filter code