Skip to content

[Docs-ai] : Enrich docs-ai query context with anchor URL #35950

Merged
onceLearner merged 1 commit intomasterfrom
reda.elissati/contextualize-docs-ai
Apr 16, 2026
Merged

[Docs-ai] : Enrich docs-ai query context with anchor URL #35950
onceLearner merged 1 commit intomasterfrom
reda.elissati/contextualize-docs-ai

Conversation

@onceLearner
Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Adds anchor_url to the Docs AI chat request payload to give the more awareness of which documentation page the user is currently browsing.
When a user asks a question like "what does this page cover?" or "how do I configure this?", so the backend can prioritize content from the page the user is browsing.

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.

AI assistance

Additional notes

@onceLearner onceLearner marked this pull request as ready for review April 13, 2026 17:56
@onceLearner onceLearner requested a review from a team as a code owner April 13, 2026 17:56
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Apr 13, 2026
@onceLearner onceLearner merged commit 24dd130 into master Apr 16, 2026
19 of 20 checks passed
@onceLearner onceLearner deleted the reda.elissati/contextualize-docs-ai branch April 16, 2026 08:25
jeff-morgan-dd pushed a commit that referenced this pull request Apr 16, 2026
StefonSimmons pushed a commit that referenced this pull request Apr 16, 2026
jeff-morgan-dd added a commit that referenced this pull request Apr 16, 2026
* Adding backlog of blog links

* Clean up blog links

* Remove duplicate link

* Update content/en/monitors/configuration/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/sheets/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/monitors/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/service_level_objectives/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/observability_pipelines/rehydration.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/network_monitoring/network_path/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* Remove unrelated links per suggestions from code review

Co-authored-by: Bryce Eadie <[email protected]>

* Updating link order

* Reorganize links for consistent ordering

* Link ordering updates

* Apply suggestions from code review

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/actions/agents/_index.md

Co-authored-by: Bryce Eadie <[email protected]>

* [CONTINT-5127] Update cluster naming rules (#35000)

* Update cluster naming rules

Co-authored-by: Bryce Eadie <[email protected]>

* Update SCA vulnerability database timing to include malicious packages (#35989)

Co-authored-by: Claude Sonnet 4.6 <[email protected]>

* [RUM] RUM Managed Archive (#35691)

* Add initial documentation for RUM Managed Archive

* Update RUM Managed Archive docs and add screenshots

* Update RUM Managed Archive docs with navigation, setup, and query improvements

* Restructure How Managed Archive works section and refine note formatting

* Update content/en/real_user_monitoring/managed_archive.md

Co-authored-by: Rosa Trieu <[email protected]>

* Update content/en/real_user_monitoring/managed_archive.md

Co-authored-by: Rosa Trieu <[email protected]>

* Update content/en/real_user_monitoring/managed_archive.md

Co-authored-by: Rosa Trieu <[email protected]>

* Update content/en/real_user_monitoring/managed_archive.md

Co-authored-by: Rosa Trieu <[email protected]>

* Update content/en/real_user_monitoring/managed_archive.md

Co-authored-by: Rosa Trieu <[email protected]>

* Apply reviewer suggestions to managed_archive.md

* Remove redundant paragraph, move bullets before screenshot

* Update screenshots and refine Recover sessions section

* Remove overview screenshot and unused asset

* Remove preview callout

---------

Co-authored-by: Rosa Trieu <[email protected]>

* [MLOB] update  llm observability auto-instrumentation docs (#34538)

* cut down on troubleshooting sections, add package and integration names

* Update content/en/llm_observability/instrumentation/auto_instrumentation.md

Co-authored-by: Bryce Eadie <[email protected]>

* Update content/en/llm_observability/instrumentation/auto_instrumentation.md

Co-authored-by: Bryce Eadie <[email protected]>

* add in link reference

* fix link location

---------

Co-authored-by: Bryce Eadie <[email protected]>

* Remove otel. metric prefix documentation (#35828)

* Remove otel. metric prefix documentation

The Datadog Exporter no longer prepends otel. to
system.* and process.* metrics. Update docs to reflect
the new behavior across metrics mapping, query metrics,
runtime metrics, and Kafka metrics pages.

* Clean up redundant section and orphaned link refs

Remove the "How OpenTelemetry metrics appear in Datadog" section
that was restating the overview. Simplify runtime metrics prefix
sentence and remove unused link definitions.

* add reference tables toolset doc to MCP docs (#35140)

* add reference tables toolset doc to MCP docs

* address PR suggestions: use backticks for inline values

* [OTAGENT-923] Add docs for DDOT Windows preview (#35951)

* Draft DDOT windows docs

* Apply suggestion from @brett0000FF

Co-authored-by: Brett Blue <[email protected]>

---------

Co-authored-by: Brett Blue <[email protected]>

* Add fleet tracers, clusters, and instrumented pods endpoints (#35881)

Co-authored-by: ci.datadog-api-spec <[email protected]>

* Add unified SDK mobile vitals cdocs pages (#35860)

* Migrate mobile vitals pages to unified SDK cdocs format

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* Add shared overview partial to mobile vitals shortcodes

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* update/remove image and navigation

* fixes

* [DOCS-11179] Rearrange track user interactions

* Revert "[DOCS-11179] Rearrange track user interactions"

This reverts commit 0f69929.

* correct and add links per dom comments

---------

Co-authored-by: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13867] Fix DatadogProviderConfiguration constructor in Expo setup code sample (#35855)

* Fix DatadogProviderConfiguration constructor in Expo setup code sample

The code sample used invalid JavaScript syntax, passing configuration
properties as flat positional arguments instead of wrapping them in an
options object as the SDK constructor expects.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Add TrackingConsent import and fix constructor in React Native setup snippets

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>

* Update generate_metrics.md to remove access request info (#35992)

Removed callout about requesting access to custom metrics from traces.

* e-linds/Update inferred_services.md (#36014)

* e-linds/Update installation.md with namespace context (#36011)

* e-linds/Update installation.md with namespace context

* Update content/en/containers/kubernetes/installation.md

Co-authored-by: domalessi <[email protected]>

---------

Co-authored-by: domalessi <[email protected]>

* Reorganize MCP Server toolsets and tools (Redux) [DOCS-13846] (#35931)

* move tools to new separate page, add to nav

* move Toolsets section from _index.md to setup.md

* clean up _index.md: remove moved sections, add tools pointer and further reading

* update cross-refs in setup.md, remove redundant heading from tools.md

* add toolset section headers and rewrite intro in tools.md

* add Dashboards tools, reorder & create new section

per  #35891

* fix heading, links

* add toolset descriptions to new Tools page

* update from master: add alerting tools

per #35941

* reorder toolsets instructions & list

* split toolsets into GA and Preview lists

* add short toolset setup instructions to Tools page

* add link to Toolsets section from landing page

* fix heading capitalization (sentence-case)

* update from master: add reference tables toolset

per #35140

* apply feedback from review

* [DOCS-13990] Update SSI instrumentation rules docs for Linux and Windows (#35980)

* [DOCS-13990] Add instrumentation rules to Windows SSI docs, update Linux

- Remove preview callout from Linux instrumentation rules section
- Update attributes table on Linux: rename Executable File Path to Executable Full Path, add Entry Point File
- Add Define instrumentation rules section to Windows SSI page with full attributes table including IIS Application Pool
- Add example use cases with annotated screenshots to both pages

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13990] Address PR review feedback

- Add Advanced options section to Windows page, move instrumentation rules under it
- Add second example to both Linux and Windows using collapse-content menus
- Fix alt text: shorten and add missing periods
- Trim Entry Point File and IIS Application Pool table descriptions
- Soften absolute claim in IIS Application Pool description

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13990] Remove periods from alt text

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13990] Use HTML tags for code and bold inside collapse-content shortcodes

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13990] Add Linux example 2 image and update example text

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* [DOCS-13990] Fix missing article and style IIS Application Pool in examples

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

* Apply suggestions from code review

Co-authored-by: domalessi <[email protected]>

---------

Co-authored-by: Claude Sonnet 4.6 <[email protected]>

* [BITS-4136] Add retention info for Bits AI SRE investigations (#35550)

* add retention info for Bits AI SRE investigations

* Update content/en/data_security/data_retention_periods.md

---------

Co-authored-by: domalessi <[email protected]>

* Add minimum Kafka ACL permissions for Kafka Monitoring and Messages (#35817)

* Add minimum Kafka ACL permissions for Kafka Monitoring and Messages

Document the minimum Kafka ACL permissions required for the Datadog Agent
when connecting to ACL-enabled Kafka clusters.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Address PR review comments

- Move ACL permissions section after the setup image and paragraph in _index.md
- Nest Kafka ACL permissions under Prerequisites (as H3) in messages.md

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Move message reading permissions to _index.md, revert messages.md

Add a second table for Read on TOPIC (message viewing) below the
monitoring permissions table. Revert all changes to messages.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Remove messages.md, consolidate into Kafka Monitoring page

Delete the separate messages.md page and add aliases for redirects.
Remove the Messages nav menu entry. Update _index.md to remove the
dead link to messages.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Revert messages.md deletion, keep ACL permissions in _index.md only

Restore messages.md and nav menu to original state. ACL permissions
for both monitoring and message reading are in the Kafka Monitoring
page only.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Update content/en/data_streams/kafka/_index.md

Co-authored-by: domalessi <[email protected]>

* Update content/en/data_streams/kafka/_index.md

Co-authored-by: domalessi <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Co-authored-by: domalessi <[email protected]>

* Add private: true to mobile vitals Cdocs pages (#36013)

* Add private: true to mobile vitals Cdocs pages

Mark the unified client_sdks/mobile_vitals and all SDK-specific mobile vitals wrapper pages as private so they are excluded from sitemap and search.

* Remove private: true from SDK-specific mobile vitals pages

* adding files (#36022)

* tag files in account management folder (#36017)

* [SDTEST-3547] Updated test tags examples (#35994)

* updated test tags examples
* updated variable name

* Pull WP agent documentation from 7.78.x branch (#36007)

* feat: add context to the chat (#35950)

* Add team and assignee filters for Search Error Tracking Issues API (#35900)

Co-authored-by: ci.datadog-api-spec <[email protected]>

* follow-up fixes to toolsets instructions (#36019)

* [Phrase] Translation Updates - 2026-04-01 (#35694)

* Updates 18 translation(s)

* Reverted further_reading tags from English back to translated language

* claude assist

Signed-off-by: Brian Deutsch <[email protected]>

* inject headings to backfill anchor links

Signed-off-by: Brian Deutsch <[email protected]>

---------

Signed-off-by: Brian Deutsch <[email protected]>
Co-authored-by: webops-guacbot[bot] <214537265+webops-guacbot[bot]@users.noreply.github.com>
Co-authored-by: jeff-morgan-dd <[email protected]>
Co-authored-by: Brian Deutsch <[email protected]>

* [Phrase] [Phase 2+3] Translation Updates - 2026-04-15 (#36016)

* Updates 52 translation(s)

* claude fixes

Signed-off-by: Brian Deutsch <[email protected]>

---------

Signed-off-by: Brian Deutsch <[email protected]>
Co-authored-by: webops-guacbot[bot] <214537265+webops-guacbot[bot]@users.noreply.github.com>
Co-authored-by: Brian Deutsch <[email protected]>

* fix: restore correct OWASP acronym expansion in terms glossary (#36036)

JJ-Change-Id: mwoxlk

Co-authored-by: May Lee <[email protected]>

* Clarify OpenTelemetry output format support for metrics (#36029)

Updated note on metric streaming to clarify support for OpenTelemetry output formats.

* Resolve merge conflict

---------

Signed-off-by: Brian Deutsch <[email protected]>
Co-authored-by: Bryce Eadie <[email protected]>
Co-authored-by: Jon Rosario <[email protected]>
Co-authored-by: Gorka Vicente <[email protected]>
Co-authored-by: Claude Sonnet 4.6 <[email protected]>
Co-authored-by: qsellem <[email protected]>
Co-authored-by: Rosa Trieu <[email protected]>
Co-authored-by: Sam Brenner <[email protected]>
Co-authored-by: Brett Blue <[email protected]>
Co-authored-by: Guillaume Brizolier <[email protected]>
Co-authored-by: Stanley Liu <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>
Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: Ida Adjivon <[email protected]>
Co-authored-by: Merve Bolat <[email protected]>
Co-authored-by: e-linds <[email protected]>
Co-authored-by: domalessi <[email protected]>
Co-authored-by: Joe Peeples <[email protected]>
Co-authored-by: Dan Hodge <[email protected]>
Co-authored-by: Piotr WOLSKI <[email protected]>
Co-authored-by: cecilia saixue wat-kim <[email protected]>
Co-authored-by: Yehor Popovych <[email protected]>
Co-authored-by: Yoann Ghigoff <[email protected]>
Co-authored-by: Reda El Issati <[email protected]>
Co-authored-by: webops-guacbot[bot] <214537265+webops-guacbot[bot]@users.noreply.github.com>
Co-authored-by: Brian Deutsch <[email protected]>
Co-authored-by: Romain Marcadier <[email protected]>
Co-authored-by: May Lee <[email protected]>
Co-authored-by: helenefav <[email protected]>
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants