open-telemetry / open-telemetry/opentelemetry-cpp

Auto generate documentation for cmake components

Open
#3,398 1 comment 1 reaction 1 assignee View on GitHub

@dbarker is already working on this.

Since May 9, 2025.

Stale triage/accepted
Dominant language
C++
Stars
1.4k
Forks
632
Avg merge
1d 13h
Merged PRs (30d)
75

Description

Follow up to #3368 and @owent's idea to generate documentation automatically for cmake components

  • Add an optional DESCRIPTION argument to the otel_add_components function
  • Generate the documentation block of the opentelemetry-cpp-config.cmake file based on the components and targets installed
  • Generate a markdown file with the components and targets supported and link to it with the INSTALL file. (provide instructions on how to generate this file).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.