Document firstOrFail and collection methods.

Document the new method and the ability to use collection methods on query objects.

Refs #2079
We should add another comment explaining that it returns another collection, so to see the contents you need to convert to array or json_encode() it