Skip to content

[DOCS] Improve clarity of DBM self-hosted Postgres setup page#35912

Open
michaelperalta wants to merge 2 commits intomasterfrom
mike.peralta/dbm-postgres-selfhosted-clarity
Open

[DOCS] Improve clarity of DBM self-hosted Postgres setup page#35912
michaelperalta wants to merge 2 commits intomasterfrom
mike.peralta/dbm-postgres-selfhosted-clarity

Conversation

@michaelperalta
Copy link
Copy Markdown

What does this PR do? What is the motivation?

Clarity improvements to the Database Monitoring setup page for self-hosted Postgres.

  • Split the postgresql.conf parameters table into Required and Optional sections
  • Added explicit ### Create the explain plan function heading (it was orphaned after version tabs, making it easy to miss)
  • Fixed the Postgres 9.6 "Verify" tab — it was identical to the ≥10 tab; the 9.6 tab now correctly uses the datadog.pg_stat_activity() and datadog.pg_stat_statements() function forms required for that version
  • Renamed verification sections for consistency: "Verify database permissions" (after Grant) and "Verify Agent setup" (after Install)
  • Simplified the dense "Grant the Agent access" intro paragraph
  • Fixed passive voice and removed Vale style violations
  • Consolidated duplicate reference links ([10] and [16] both pointed to the same restart URL)
  • Fixed title hyphenation: "Self-Hosted"

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

- Split config parameters table into Required/Optional sections
- Add explicit heading for explain plan function (was orphaned after version tabs)
- Fix 9.6 Verify tab to use function form (was identical to ≥10 tab)
- Rename sections for consistency: "Verify database permissions" and "Verify Agent setup"
- Simplify dense Grant intro paragraph
- Fix passive voice and remove style violations
- Consolidate duplicate reference links
- Fix title hyphenation: "Self-Hosted"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@michaelperalta michaelperalta requested review from a team as code owners April 10, 2026 17:27
@github-actions
Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@git-thuerk-done git-thuerk-done added the editorial review Waiting on a more in-depth review label Apr 10, 2026
@git-thuerk-done
Copy link
Copy Markdown
Contributor

git-thuerk-done commented Apr 10, 2026

Editorial review tracked in DOCS-13973 (batch review with PRs #35913, #35914, #35915, #35916, #35917, #35918).

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

Labels

editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants