Skip to content

DOCS-11221: Move IaC docs to Code Security #29947

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Jun 23, 2025

Conversation

drichards-87
Copy link
Contributor

What does this PR do? What is the motivation?

DOCS-11221.

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@drichards-87 drichards-87 added WORK IN PROGRESS No review needed, it's a wip ;) Do Not Merge Just do not merge this PR :) labels Jun 13, 2025
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Jun 13, 2025
Copy link
Contributor

github-actions bot commented Jun 13, 2025

✅ Documentation Team Review

The documentation team has approved this pull request. Thank you for your contribution!

@github-actions github-actions bot added the Images Images are added/removed with this PR label Jun 16, 2025
@drichards-87 drichards-87 marked this pull request as ready for review June 16, 2025 21:01
@drichards-87 drichards-87 requested review from a team as code owners June 16, 2025 21:01
Copy link
Contributor

@michaelcretzman michaelcretzman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor suggestions

Comment on lines 24 to 33
## Key capabilities

With IaC Security, you can:

- Scan Terraform files for security misconfigurations
- Surface IaC misconfigurations in the Code Security Vulnerabilities tab
- Group and filter findings by severity, triage status, and other facets
- View detailed remediation guidance and code snippets for each finding
- Track finding status and history for triage and resolution
- Configure scanning exclusions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is essentially a bulleted list of the introductory paragraph. My suggestion is to keep the opening intro sentence ("Infrastructure as Code (IaC) Security automatically analyzes your Terraform files for security misconfigurations.") and then just using the bulleted list. Skip the paragraph.

## Getting started

1. [Set up IaC Security][1] in your environment
2. Configure [scanning exclusions][2] if needed
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how do they know if they need this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point. I'll update the description.

drichards-87 and others added 2 commits June 23, 2025 09:33
Co-authored-by: Michael Cretzman <58786311+michaelcretzman@users.noreply.github.com>
@drichards-87 drichards-87 added editorial review Waiting on a more in-depth review and removed WORK IN PROGRESS No review needed, it's a wip ;) Do Not Merge Just do not merge this PR :) labels Jun 23, 2025
@drichards-87 drichards-87 merged commit 8c7ffa6 into master Jun 23, 2025
18 of 19 checks passed
@drichards-87 drichards-87 deleted the deforest/docs-11221-move-iac-to-code-security branch June 23, 2025 17:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review Images Images are added/removed with this PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants