docs: def lint_file(file_path):
      """
      Validate & lint `file_path` and return a LintResult.
  
      :param file_path: YAML filename
      :type file_path: str
      :return: LintResult object
      """
  
      with open(file_path, 'r') as yaml:
          try:
              return lint(yaml)
          except Exception as e:
              lr = LintResult()
              lr.add_error('could not parse YAML: %s' % e, exception=e)
              return lr