Skip to content

fix(docs): replace RST :func: role with Markdown in configure_distributed_tracing docstring - #248

Closed
etserend wants to merge 1 commit into
mainfrom
fix/hybim-tbd-rst-docstring-http-instrumentation
Closed

etserend wants to merge 1 commit into
mainfrom
fix/hybim-tbd-rst-docstring-http-instrumentation

Conversation

@etserend

Copy link
Copy Markdown
Contributor

Summary

  • Replaces :func:\instrument_distributed_tracing`with ``instrument_distributed_tracing()`` in theconfigure_distributed_tracingdocstring insrc/splunk_ao/http_instrumentation.py`
  • The Sphinx/RST :func: role is not supported in the MDX doc pipeline and renders as raw text in the published docs site

Context

Spotted during review of agent-observability-docs #68 by @sheilattran8. The sdk-api/python/reference/http_instrumentation.mdx file is autogenerated — fixing the source docstring here is the right path; docs will self-correct on the next SDK publish.

Test plan

  • Verify src/splunk_ao/http_instrumentation.py line 280 no longer contains :func:
  • After merge + publish, confirm sdk-api/python/reference/http_instrumentation.mdx line 54 renders correctly in the docs site

🤖 Generated with Claude Code

…istributed_tracing docstring

The Sphinx :func: role renders as raw RST text in the autogenerated MDX
published to the docs site. Replace with plain backtick syntax so the
generated http_instrumentation.mdx renders correctly.

Spotted in agent-observability-docs PR #68 review.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@etserend etserend closed this Sep 16, 2026
@etserend
etserend deleted the fix/hybim-tbd-rst-docstring-http-instrumentation branch September 16, 2026 15:42
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 16, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant