Improve filter documentation

fixes #21