Skip to content

Conversation

ptgott
Copy link
Contributor

@ptgott ptgott commented Sep 22, 2025

The index page of the Infrastructure as Code section of the docs was originally intended to explain dynamic resources, so links to the guides contained within the section are neither up to date nor particularly visible. This change improves the visibility of links to the sections within the IaC section, and focuses the IaC index page more on its current purpose.

Edit the IaC index page to:

  • Explain dynamic resources in terms of IaC tools.
  • Remove information that is already included elsewhere, and not relevant to using IaC tools to manage Teleport.
  • Update reference links. Add links to Operator and Terraform provider resource references.
  • Move key guide links to the introductory section of this page.
  • Remove the example manifests, since these aren't necessary once a user chooses to get started with a particular IaC tool. The examples are too minimal to be useful, but long enough to take up substantial space within the guide. This helps shorten the guide and focus on key information.

@github-actions github-actions bot added documentation no-changelog Indicates that a PR does not require a changelog entry size/sm labels Sep 22, 2025
Copy link

github-actions bot commented Sep 22, 2025

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
paul.gottschling/2025-09-22-iac-index d2a3133 7 ✅SUCCEED paul-gottschling-2025-09-22-iac-index 2025-10-16 17:54:07

@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from c7193a6 to c5a2c0f Compare September 23, 2025 15:37
@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from c5a2c0f to 07de286 Compare September 25, 2025 14:28
@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from 07de286 to 2ebfc54 Compare September 29, 2025 13:01
@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from 2ebfc54 to de2ce84 Compare September 30, 2025 15:28
@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from de2ce84 to 29f99a7 Compare October 9, 2025 14:27
@ptgott
Copy link
Contributor Author

ptgott commented Oct 9, 2025

@mmcallister Checking if you have time to review this one. Thanks!

The index page of the Infrastructure as Code section of the docs was
originally intended to explain dynamic resources, so links to the guides
contained within the section are neither up to date nor particularly
visible. This change improves the visibility of links to the sections
within the IaC section, and focuses the IaC index page more on its
current purpose.

Edit the IaC index page to:
- Explain dynamic resources in terms of IaC tools.
- Remove information that is already included elsewhere, and not
  relevant to using IaC tools to manage Teleport.
- Update reference links. Add links to Operator and Terraform provider
  resource references.
- Move key guide links to the introductory section of this page.
- Remove the example manifests, since these aren't necessary once a user
  chooses to get started with a particular IaC tool. The examples are
  too minimal to be useful, but long enough to take up substantial space
  within the guide. This helps shorten the guide and focus on key
  information.
@ptgott ptgott force-pushed the paul.gottschling/2025-09-22-iac-index branch from 29f99a7 to d2a3133 Compare October 16, 2025 17:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/branch/v18 documentation 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.

2 participants