techdocs/docs/analysis/resources
Nate W 5f769ae529 correcting links, reformatting tables, other formatting corrections
Signed-off-by: Nate W <natew@cncf.io>
Signed-off-by: Patrice Chalin <pchalin@gmail.com>
2024-05-31 12:13:45 -04:00
..
README.md correcting links, reformatting tables, other formatting corrections 2024-05-31 12:13:45 -04:00
analysis-template.md correcting links, reformatting tables, other formatting corrections 2024-05-31 12:13:45 -04:00
implementation-template.md Final (hopefully) changes to the techdoc analysis materials. Directory structure chnages included. 2024-05-31 12:13:45 -04:00
issue-template.md Final (hopefully) changes to the techdoc analysis materials. Directory structure chnages included. 2024-05-31 12:13:45 -04:00
umbrella-issue-template.md Final (hopefully) changes to the techdoc analysis materials. Directory structure chnages included. 2024-05-31 12:13:45 -04:00

README.md

TechDoc Analysis Templates

This directory contains templates for analyzing a CNCF project's documentation.

Contents

Use the templates in this directory to perform a documentation analysis for CNCF. These materials provide:

  • A relatively objective set of criteria (a "rubric") for evaluating existing documentation and website content, infrastructure, and support.
  • An attempt to make the documentation analysis appropriate to the current (or proposed) maturity level for the overall project.
  • Emphasis on effective documentation that serves all users associated with the project.

Resources for completing a documentation analysis, including a how-to guide and analysis criteria, are in the docs directory.