filters: added some documentation and a basic example for a filter

Signed-off-by: Arun Persaud <apersaud@lbl.gov>