Skip to content

docs: updated the "Read The Docs" documentation #4728

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

jscancella
Copy link

Description

I noticed that several of the examples didn't link to their source code on github even though others did. To be consistent I added a link to the example in the README.rst files.

While working on this I also noticed that there was an example for prometheus but no entry in the Read The Docs generated, so I added one following the same style as the other pages.

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update
  • Documentation

How Has This Been Tested?

generated documentation locally and inspected the html files. I checked all the links and make sure they were pointing to correct github example page.

@jscancella jscancella requested a review from a team as a code owner August 18, 2025 23:28
Copy link

linux-foundation-easycla bot commented Aug 18, 2025

CLA Signed

The committers listed above are authorized under a signed CLA.

@xrmx
Copy link
Contributor

xrmx commented Aug 19, 2025

@jscancella Thanks for the PR but you need to sign the CLA in order to contribute to OpenTelemetry.

@jscancella
Copy link
Author

ok, I just signed the agreement. Will it automatically pick that up or is there something else I need to do to kick it off again?

Prometheus Instrumentation
==========================

This shows how to use ``opentelemetry-exporter-prometheus`` to automatically generate prometheus metrics.
Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks for this PR! Nit: I think "Prometheus" should be capitalized

Suggested change
This shows how to use ``opentelemetry-exporter-prometheus`` to automatically generate prometheus metrics.
This shows how to use ``opentelemetry-exporter-prometheus`` to automatically generate Prometheus metrics.

@tammy-baylis-swi
Copy link
Contributor

Please could you also add an entry to the Changelog for this update.

Co-authored-by: Tammy Baylis <96076570+tammy-baylis-swi@users.noreply.github.com>
$ python ./prometheus-monitor.py
$ Server is running at http://localhost:8000
Now you can visit `localhost:8000/metrics <http://localhost:8000/metrics>` to see Prometheus metrics.
Copy link
Contributor

Choose a reason for hiding this comment

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

The docs ci/cd doesn't like this format. Maybe plain http://localhost:8000/metrics or `http://localhost:8000/metrics` instead?

Copy link
Author

Choose a reason for hiding this comment

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

done

@jscancella
Copy link
Author

Please could you also add an entry to the Changelog for this update.

Added an entry - but let me know if there is a different format or anything that needs to be changed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants