Skip to content
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

[DOCUMENTATION] Update terms in documentation #448

Merged
merged 1 commit into from
Nov 8, 2023

Conversation

kfdm
Copy link
Collaborator

@kfdm kfdm commented Nov 6, 2023

Some of these terms have not been updated in a while and need to be updated to show the current relationship between them.

@kfdm kfdm requested a review from a team as a code owner November 6, 2023 01:51
A service in Prometheus is a group of related Projects and are assigned to a
specific shard
A service in Prometheus is a group of related Projects and Rules and are the
main top-level object.
Copy link
Contributor

Choose a reason for hiding this comment

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

Could we rephrase this sentence? It is a little bit difficult to understand.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

What would you recommend then?

Copy link
Contributor

Choose a reason for hiding this comment

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

What would you recommend then?

I am not sure. Maybe this?

"A Service in Prometheus is a group of related Projects and Rules. Those three are the
main top-level objects."

Are there other top-level objects that are not considered "main"?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I realized I need to fix this anyways, because service is a Promgen concept and not Prometheus.

A service in Promgen is a group of related Projects and Rules.
Service is typically the top-level object in Promgen.

Copy link
Contributor

@vincent-olivert-riera vincent-olivert-riera left a comment

Choose a reason for hiding this comment

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

I realized I didn't approve this PR before. The comments were optional, by the way.

Some of these terms have not been updated in a while and need to be
updated to show the current relationship between them.
Copy link
Contributor

@vincent-olivert-riera vincent-olivert-riera 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 to me 👍🏻

@kfdm kfdm merged commit 01322ba into line:master Nov 8, 2023
4 checks passed
@kfdm kfdm deleted the update-glossary branch November 8, 2023 06:17
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.

2 participants