docs: def write_readme(self, role):
          """
          Write out a new readme file.
          """
          j2_out = self.readme_template.render(self.readme_template_vars)
  
          self.update_gen_report(role, "readme", j2_out)