Skip to content

Clean up the Enroll Resources docs sidebar section#62133

Merged
ptgott merged 1 commit intomasterfrom
paul.gottschling/2025-12-09-enroll
Dec 15, 2025
Merged

Clean up the Enroll Resources docs sidebar section#62133
ptgott merged 1 commit intomasterfrom
paul.gottschling/2025-12-09-enroll

Conversation

@ptgott
Copy link
Copy Markdown
Contributor

@ptgott ptgott commented Dec 10, 2025

Make it easier for readers to navigate this section by reducing noise in the sidebar. This change modifies sidebar labels to reduce length, remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to improve clarity and reduce the number of items in a given section:

  • Move guides to enrolling specific databases to enroll-resources/database-access/enrollment, and shorten individual guide slugs since we don't need to include the substring enroll-.
  • Move the Kubernetes application discovery reference to the Kubernetes application discovery section. The reference is specific to Kubernetes application discovery, and makes more sense in the Kubernetes application discovery subsection.
  • Remove the Server Access introduction page, since it is redundant with the landing page.
  • Replace the "Applications" section "Guides" with a "Configuration Guides" section, which is more thematically specific.
  • Move the Ansible guide from "Servers" to "User Guides". This doesn't require tctl, and is for end-users who want to set up an Ansible playbook using Teleport credentials. Rephrase a Troubleshooting item that mentions tctl to indicate taht admins must complete the task.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Dec 10, 2025

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
paul.gottschling/2025-12-09-enroll 8b39c69 8 ✅SUCCEED paul-gottschling-2025-12-09-enroll 2025-12-15 15:01:08

@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 97d84da to 7c59c60 Compare December 10, 2025 17:00
@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 7c59c60 to 0160416 Compare December 10, 2025 18:17
@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 0160416 to 76572f5 Compare December 10, 2025 18:49
@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 76572f5 to 3723010 Compare December 10, 2025 19:25
@ptgott ptgott marked this pull request as ready for review December 10, 2025 19:56
@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 3723010 to 68cb97a Compare December 10, 2025 19:56
@github-actions github-actions bot requested a review from greedy52 December 10, 2025 19:57
@github-actions github-actions bot added the helm label Dec 10, 2025
@github-actions github-actions bot requested a review from hugoShaka December 10, 2025 19:57
Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
@ptgott ptgott force-pushed the paul.gottschling/2025-12-09-enroll branch from 4f66695 to 8b39c69 Compare December 15, 2025 14:51
@ptgott ptgott enabled auto-merge December 15, 2025 14:52
@ptgott ptgott added this pull request to the merge queue Dec 15, 2025
Merged via the queue into master with commit 99c78ea Dec 15, 2025
43 checks passed
@ptgott ptgott deleted the paul.gottschling/2025-12-09-enroll branch December 15, 2025 15:11
@backport-bot-workflows
Copy link
Copy Markdown
Contributor

@ptgott See the table below for backport results.

Branch Result
branch/v18 Failed

ptgott added a commit that referenced this pull request Dec 15, 2025
Backports #62133

Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
ptgott added a commit that referenced this pull request Dec 15, 2025
Backports #62133

Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
ptgott added a commit that referenced this pull request Dec 16, 2025
Backports #62133

Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
github-merge-queue bot pushed a commit that referenced this pull request Dec 16, 2025
Backports #62133

Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
21KennethTran pushed a commit that referenced this pull request Jan 6, 2026
Make it easier for readers to navigate this section by reducing noise in
the sidebar. This change modifies sidebar labels to reduce length,
remove repeated words, and add a more logical order.

This change also reorganizes some sections of the sidebar in order to
improve clarity and reduce the number of items in a given section:

- Move guides to enrolling specific databases to
  `enroll-resources/database-access/enrollment`, and shorten individual
  guide slugs since we don't need to include the substring `enroll-`.
- Move the Kubernetes application discovery reference to the Kubernetes
  application discovery section. The reference is specific to Kubernetes
  application discovery, and makes more sense in the Kubernetes
  application discovery subsection.
- Remove the Server Access introduction page, since it is redundant with
  the landing page.
- Replace the "Applications" section "Guides" with a "Configuration
  Guides" section, which is more thematically specific.
- Move the Ansible guide from "Servers" to "User Guides". This doesn't
  require tctl, and is for end-users who want to set up an Ansible
  playbook using Teleport credentials. Rephrase a Troubleshooting item
  that mentions `tctl` to indicate taht admins must complete the task.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/branch/v18 documentation helm no-changelog Indicates that a PR does not require a changelog entry size/sm

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants