create predicate documentation for existing predicates
Merge pull request #1017 from crate/m/predicate_docs

create predicate documentation for existing predicates
actually execute the examples
refactored match function to predicate