Comment

Add a note to explain the curious behavior of ResourcesMaybe with
directory matches.
Refactoring to return path elements and params together so that required
params can be calculated
Adding 'required-params' which tells you which params you must supply to
build the path
Adding path-with-query-for and tests, fixing up docs