API docs for function.predicate

I put together a first draft of the API docs for function.predicate. Let me know if you see anything that should be changed.