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

Grafana.WordList : grafana.com #988

Closed
irenerl24 opened this issue Jan 21, 2025 · 8 comments · Fixed by #1002
Closed

Grafana.WordList : grafana.com #988

irenerl24 opened this issue Jan 21, 2025 · 8 comments · Fixed by #1002

Comments

@irenerl24
Copy link
Contributor

Hello!

Can we make change this rule so that it skips "grafana" (in lowercase) when referring to grafana.com?

Image

@jdbaldry
Copy link
Member

jdbaldry commented Jan 22, 2025

I'm not sure grafana.com is a word though? I'm also not sure that grafana.com is a thing our users will understand.

I think in this instance, it should be "Grafana Labs"

Each Grafana Enterprise instance submits an anonymized list of users to Grafana Labs

WDYT?

@irenerl24
Copy link
Contributor Author

I think you're right, I'll go with your suggestion for now :) Thank you!

@jdbaldry
Copy link
Member

I wonder if we should add grafana.com -> Grafana Labs or the Grafana website to the word list.

@irenerl24 irenerl24 reopened this Jan 24, 2025
@irenerl24
Copy link
Contributor Author

Reopening this issue as it's still in discussion

@jdbaldry
Copy link
Member

jdbaldry commented Jan 24, 2025

I think people usually mean either Grafana Labs (when they're talking about sending data to us as an entity), Grafana Cloud (when they are talking about our SaaS service), or the Grafana website (when they are talking about docs or other things on our site).

Is grafana.com actually a distinct "thing" that for our users or is just one of Grafana Cloud, Grafana Labs, or the Grafana website?

@Eve832
Copy link
Contributor

Eve832 commented Jan 24, 2025

so telling people to log in to their account at grafana.com is extremely clear. Folks know exactly what to do and where to go, so I'm not sure why adding a layer of abstraction is a good thing? I have to agree with Irene on this one. I suppose one could add the wwws and https if we were to get super nitty, but I don't see what value that would bring. that is to say, I don't think we're confusing users by referring to grafana.com

@Eve832
Copy link
Contributor

Eve832 commented Jan 24, 2025

oh, but seeing how it was used above, I think Jack is correct that we can just refer to Grafana Labs in situations where we're not directing someone to the site

@jdbaldry
Copy link
Member

jdbaldry commented Jan 24, 2025

Yeah, Eve is right about the linking to a web address part. In fact if you use the full URL (including scheme), then Vale doesn't spell check that because it knows it's a URL.

So perhaps the suggestion is:

Don't use grafana.com, instead use one of the following:

  • If you're talking about Grafana Cloud, use Grafana Cloud.
  • If you're talking about the company, use Grafana Labs.
  • If you're linking to a page on the website, use the page title or the full URL including scheme. For example, https://grafana.com/.

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 a pull request may close this issue.

3 participants