Paul Gottschling 59ab788411 Make our docs guidance discoverable (#10155) ...

Make our docs guidance discoverable

Currently, our guidance for making docs changes is
organized into a /docs/docs page that is only accessible if
you know the URL. This change ensures that people who have not
received an informal training on docs contributions can
contribute in a way that abides by our expectations for
consistency and effectiveness.

- Splits the docs/docs and docs/docs/best-practices pages into
  a UI reference, getting started guide, and style guide. This
  ensures that each kind of content we have in our contributing
  guide (i.e., tutorial or reference) is accessible from the
  main nav menu.
- Adds a "Contributing" tab to the navigation menu. There is
  one subsection here related to documenation, and we can add
  another subsection later with developer guides for editing
  Teleport's code.
- Moves the "philosophy" section into the intro page of the
  documentation contribution section menu.
- Makes various edits to the original docs guidance for clarity.
- Document our docs labels in a dedicated "creating an issue"
  page

Fixes #9538

2022-02-09 16:15:49 -05:00

..

documentation

Make our docs guidance discoverable (#10155)

2022-02-09 16:15:49 -05:00

documentation.mdx

Make our docs guidance discoverable (#10155)

2022-02-09 16:15:49 -05:00