Skip to content

docs: add :members: to OTLP exporter submodule automodule directives#5124

Open
alliasgher wants to merge 3 commits intoopen-telemetry:mainfrom
alliasgher:docs/2786-otlp-exporter-api-docs
Open

docs: add :members: to OTLP exporter submodule automodule directives#5124
alliasgher wants to merge 3 commits intoopen-telemetry:mainfrom
alliasgher:docs/2786-otlp-exporter-api-docs

Conversation

@alliasgher
Copy link
Copy Markdown
Contributor

Description

The trace_exporter, metric_exporter, and _log_exporter entries in docs/exporter/otlp/otlp.rst had no Sphinx autodoc options, so their classes were not included in the generated API documentation. The top-level proto.http and proto.grpc entries already have :members:, :undoc-members:, and :show-inheritance: — the fix applies the same directives to the six submodule entries.

Fixes #2786

Type of change

  • Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

Docs-only change. Verified by inspecting the RST and comparing against sibling exporter docs (e.g. prometheus.rst) that correctly use :members: on each automodule directive.

Does This PR Require a Contrib Repo Change?

No.

Checklist

  • CHANGELOG entry added under ## Unreleased

The trace_exporter, metric_exporter, and _log_exporter entries in
docs/exporter/otlp/otlp.rst had no Sphinx autodoc options, so their
classes were not included in the generated API documentation.

Add :members:, :undoc-members:, and :show-inheritance: to each of the
six submodule automodule directives (three for proto.http, three for
proto.grpc) so the exporter classes appear on the rendered page.

Fixes open-telemetry#2786

Signed-off-by: Ali <alliasgher123@gmail.com>
@alliasgher alliasgher force-pushed the docs/2786-otlp-exporter-api-docs branch from b30a604 to 3abc890 Compare April 19, 2026 07:25
@MikeGoldsmith MikeGoldsmith added the Skip Changelog PRs that do not require a CHANGELOG.md entry label Apr 21, 2026
Copy link
Copy Markdown
Member

@MikeGoldsmith MikeGoldsmith left a comment

Choose a reason for hiding this comment

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

Looks good - thanks @alliasgher.

Let's remove the changelog entry but otherwise it's ready to go.

Comment thread CHANGELOG.md Outdated
@github-project-automation github-project-automation Bot moved this to Reviewed PRs that need fixes in Python PR digest Apr 21, 2026
@MikeGoldsmith MikeGoldsmith moved this from Reviewed PRs that need fixes to Approved PRs that need fixes in Python PR digest Apr 21, 2026
@MikeGoldsmith MikeGoldsmith moved this from Approved PRs that need fixes to Reviewed PRs that need fixes in Python PR digest Apr 21, 2026
Signed-off-by: Ali <alliasgher123@gmail.com>
Copy link
Copy Markdown
Contributor Author

@alliasgher alliasgher left a comment

Choose a reason for hiding this comment

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

Thanks @MikeGoldsmith — changelog entry removed in 564ca5e.

Copy link
Copy Markdown
Member

@MikeGoldsmith MikeGoldsmith left a comment

Choose a reason for hiding this comment

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

Thanks @alliasgher 👍🏻

@github-project-automation github-project-automation Bot moved this from Reviewed PRs that need fixes to Approved PRs in Python PR digest Apr 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Skip Changelog PRs that do not require a CHANGELOG.md entry

Projects

Status: Approved PRs

Development

Successfully merging this pull request may close these issues.

OTLP Exporters API documentation page is missing the API section

3 participants