mirror of https://github.com/cncf/techdocs.git
* Add Vitess analysis document. Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> * renaming file Signed-off-by: Nate W <natew@cncf.io> * fixing formatting issues Signed-off-by: Nate W <natew@cncf.io> * fixing formatting issues Signed-off-by: Nate W <natew@cncf.io> * Update per review comments, including recommendations for FAQ and troubleshooting. Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> * Update analyses/0014-vitess/analysis.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> * Update analyses/0014-vitess/analysis.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> * removing SEO, Analytics and local search sections as out of scope for this analyis. Signed-off-by: Nate W <natew@cncf.io> * updating spelling wordlist Signed-off-by: Nate W <natew@cncf.io> * fixing format Signed-off-by: Nate W <natew@cncf.io> * removing markdown disable no-bare-urls Signed-off-by: Nate W <natew@cncf.io> * updating codefence formatting Signed-off-by: Nate W <natew@cncf.io> * disabling fence-code-langage check on quoted content Signed-off-by: Nate W <natew@cncf.io> * fixing formatting Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> Signed-off-by: Nate W <natew@cncf.io> Co-authored-by: Nate W <natew@cncf.io> Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> |
||
|---|---|---|
| .github | ||
| analyses | ||
| docs | ||
| src | ||
| static | ||
| .cspell.yml | ||
| .gitignore | ||
| .htmltest.yml | ||
| .markdown-link-check.json | ||
| .markdownlint.yaml | ||
| .nvmrc | ||
| .prettierignore | ||
| LICENSE | ||
| LICENSE-CODE | ||
| Makefile | ||
| README.md | ||
| docusaurus.config.ts | ||
| package.json | ||
| sidebars.ts | ||
| tsconfig.json | ||
README.md
CNCF TechDocs
This site contains resources provided by the CNCF Technical Documentation team, including:
- Docs about building websites and developing technical documentation,
including recommended tools, best practices, how-tos, and evaluation
checklists. It provides specific guidelines for:
- Setting up and maintaining a documentation website.
- Writing technical documentation for a project.
- Seeking assistance from the CNCF TechDocs community.
- Analyzing project documentation.
- Analyses: a collection of documentation analyses of CNCF projects performed by the TechDocs team.
TechDocs Q&A
The CNCF TechDocs team holds a Zoom meeting to answer questions and discuss anything to do with documentation. Meetings are held on the fourth Wednesday of every month at 8am Pacific time.
Formerly called Office Hours, TechDocs Q&A started on September 30, 2020.
Assistance program for technical documentation
The TechDocs team can help CNCF projects analyze and improve their documentation. For details, see the TechDocs assistance program.
CNCF TechDocs team
The full-time staff of the team is (in alphabetical order):
- Nate Waddington - Head of mentoring & documentation
- Patrice Chalin - Senior techdoc & webdev lead
- Uchechukwu Obasi - Developer advocate
Consultants and volunteers also contribute to CNCF TechDocs efforts.
Licenses
- Documentation: CC-BY-4.0
- Code: Apache-2.0