Skip to content

[receiver/prometheus] Cleanup and restructure README#41251

Merged
songy23 merged 1 commit into
open-telemetry:mainfrom
ChristianCiach:prometheus-docs-reorder
Jul 11, 2025
Merged

[receiver/prometheus] Cleanup and restructure README#41251
songy23 merged 1 commit into
open-telemetry:mainfrom
ChristianCiach:prometheus-docs-reorder

Conversation

@ChristianCiach

Copy link
Copy Markdown
Contributor

Description

The README of this receiver is really hard to read. It seems like, over time, new sections have been inserted at really bad places, disrupting the flow of existing text.

For example, just below the Feature gates section there was this text:

- `report_extra_scrape_metrics`: Extra Prometheus scrape metrics can be reported by setting this parameter to `true`

You can copy and paste that same configuration under:

``yaml
receivers:
  prometheus:
    config:
``
  • What is report_extra_scrape_metrics talking about? What does this have to do with the RemoveStartTimeAdjustment feature gate?
  • What is You can copy and paste that same configuration under: talking about? What "configuration"? The Feature gates?

It took a while to figure out what the README tries to tell me.

I've moved the "Feature Gates" paragraph as its own section to the end of the file, to be more in line with the other READMEs.

@ChristianCiach ChristianCiach requested review from a team, ArthurSens and dashpole as code owners July 11, 2025 11:32
@github-actions github-actions Bot added the receiver/prometheus Prometheus receiver label Jul 11, 2025
@github-actions github-actions Bot requested review from Aneurysm9 and krajorama July 11, 2025 11:32
@songy23 songy23 added the Skip Changelog PRs that do not require a CHANGELOG.md entry label Jul 11, 2025
@dashpole

Copy link
Copy Markdown
Contributor

Thanks!

@songy23 songy23 merged commit 3e98f70 into open-telemetry:main Jul 11, 2025
165 of 166 checks passed
@github-actions github-actions Bot added this to the next release milestone Jul 11, 2025
@ChristianCiach ChristianCiach deleted the prometheus-docs-reorder branch July 11, 2025 20:58
Dylan-M pushed a commit to Dylan-M/opentelemetry-collector-contrib that referenced this pull request Aug 5, 2025
…41251)

#### Description

The README of this receiver is really hard to read. It seems like, over
time, new sections have been inserted at really bad places, disrupting
the flow of existing text.

For example, just below the `Feature gates` section there was this text:

```
- `report_extra_scrape_metrics`: Extra Prometheus scrape metrics can be reported by setting this parameter to `true`

You can copy and paste that same configuration under:

``yaml
receivers:
  prometheus:
    config:
``
```

* What is `report_extra_scrape_metrics` talking about? What does this
have to do with the `RemoveStartTimeAdjustment` feature gate?
* What is `You can copy and paste that same configuration under:`
talking about? What "configuration"? The Feature gates?

It took a while to figure out what the README tries to tell me.

I've moved the "Feature Gates" paragraph as its own section to the end
of the file, to be more in line with the other READMEs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

receiver/prometheus Prometheus receiver Skip Changelog PRs that do not require a CHANGELOG.md entry

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants