Skip to content

Fix Azure getting started page: UI rendering and remove unsupported Terraform step - #39727

Open
perzycharles wants to merge 1 commit into
masterfrom
yong.zuo/fix-azure-getting-started-ui
Open

Fix Azure getting started page: UI rendering and remove unsupported Terraform step#39727
perzycharles wants to merge 1 commit into
masterfrom
yong.zuo/fix-azure-getting-started-ui

Conversation

@perzycharles

@perzycharles perzycharles commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Two fixes to the Azure getting started page (/getting_started/integrations/azure).

Live page: https://docs.datadoghq.com/getting_started/integrations/azure/?tab=createanappregistration#terraform-setup

1. UI rendering fix

ui ui2

The numbered list instructions in the Quickstart and Terraform tabs were broken. The {{< ui >}} shortcode pipes its content through markdownify; when the content starts with + (e.g., + Add New App registration), the + is treated as a markdown list bullet, which wraps the text in <ul><li> and breaks the surrounding <ol>. All subsequent numbered steps were swallowed into the bullet.

Screenshots of the broken UI:

Fix: Escape the + as \+ in both the Quickstart and Terraform tab instructions.

2. Remove unsupported Terraform step

Removed the "Configure log collection" step (step 6) from the Terraform "Create an app registration" tab — this flow is not supported for the Terraform setup method. The orphaned [102] link reference was also cleaned up.

Merge readiness

  • Ready for merge

For Datadog employees:

  • ⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
  • 🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

AI assistance

Changes drafted with Claude Code assistance.

Additional notes

…rraform step

- Escape + in ui shortcode to prevent markdownify treating it as a list bullet
- Remove Configure log collection step from Terraform setup (not supported)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@perzycharles
perzycharles requested a review from a team as a code owner September 4, 2026 03:40
@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@perzycharles

Copy link
Copy Markdown
Contributor Author

/review

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🤖 Automated review by Claude. AI-generated; verify before acting.

Small formatting/scope change in hugo/content/en/getting_started/integrations/azure.md. No blockers found — the \+ escape aligns with the pattern used elsewhere in the repo (e.g., content/*/actions/app_builder/variables.md) for the same UI shortcode, and the removed Terraform log-collection step appears to be an intentional scope change.

Reviewed 18d162e378b65406689b0a44013da37952660711workflow run

@hestonhoffman hestonhoffman left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants