CNCF TechDocs Team
Go to file
Dave Welsch 77d8246375
Add Vitess analysis document (#284)
* 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>
2025-04-08 08:21:31 -07:00
.github [CI] GitHub workflow cleanup 2025-02-26 04:54:19 -05:00
analyses Add Vitess analysis document (#284) 2025-04-08 08:21:31 -07:00
docs [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
src Docusaurus version of docs pages (#301) 2025-03-17 12:55:23 -04:00
static [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
.cspell.yml updating domain and netlify information (#299) 2025-03-12 16:42:44 +00:00
.gitignore [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
.htmltest.yml [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
.markdown-link-check.json Adjust markdown syntax of analyses pages (#302) 2025-03-18 11:24:18 -04:00
.markdownlint.yaml Docusaurus version of docs pages (#301) 2025-03-17 12:55:23 -04:00
.nvmrc [CI] Run checks over PRs (#235) 2024-05-27 14:49:20 -07:00
.prettierignore Initialize the Japanese Localization Guidelines (#259) 2024-07-01 18:05:49 -07:00
LICENSE Fix licenses (#305) 2025-03-19 07:31:07 -04:00
LICENSE-CODE Fix licenses (#305) 2025-03-19 07:31:07 -04:00
Makefile [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
README.md Revise README, update PC role, add links (#309) 2025-03-19 10:09:15 -07:00
docusaurus.config.ts [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
package.json [CI] Use htmltest for link checking (#310) 2025-03-19 13:45:05 -04:00
sidebars.ts Docusaurus version of docs pages (#301) 2025-03-17 12:55:23 -04:00
tsconfig.json Docusaurus version of docs pages (#301) 2025-03-17 12:55:23 -04:00

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):

Consultants and volunteers also contribute to CNCF TechDocs efforts.

Licenses