add some documentation on the filter api