(refactor) Rewrite parsedfile method names for clarity

This renames the ParsedFile `self.find_resource` method to
`self.resource_for_record` and changes the method return to return the
resource found. It also adds some yardoc for the methods involved.
(#2251) add specs around resource_for_record