This repository holds resources provided by the CNCF Technical Documentation team. The repo contains the following directories:
docs
contains collected resources for building websites and developing documentation, including recommended tools and practices, how-tos, and evaluation checklists. Included are specific guidelines for:- Setting up and maintaining a documentation website.
- Writing technical documentation for a project.
- Getting assistance from the CNCF TechDocs community.
- Analyzing project documentation, for use by CNCF TechDocs staff (in
docs/analysis
).
analyses
(not to be confused withdocs/analysis
) contains all the completed documentation analyses.
The CNCF tech docs team holds a Zoom call to answer questions and discuss anything to do with documentation. Calls are held on the fourth Wednesday of every month at 8am Pacific time.
TechDocs Q&A (formerly called Office Hours) started on 30 September 2020.
We store ongoing meeting notes in a Google doc.
The TechDocs team can help CNCF projects analyze and improve their documentation. For details, see the TechDocs assistance program.
The full-time staff of the CNCF Tech Docs team is:
GitHub ID | Role |
---|---|
@chalin | Senior technical writer |
@nate-double-u | Developer advocate & technical writer |
@thisisobate | Developer advocate |
Various consultants and volunteers also contribute to CNCF Tech Docs projects.