Improve our filter documentation
Description
This MR aims to improve our filter documentation.
The patch ensures that all improvements will be seen at: https://docs.buildstream.build/elements/filter.html which I believe to be the most sensible place to host such changes.
Closes #278 (closed)