Add ADOPTERS.md

[RichiH]

No description provided.

[brian-brazil]

We already have one of these on the front page, and I'd prefer not to have to deal with several hundred PRs of companies adding themselves. A wiki requires no maintenance on our part if you really feel the need to have one of these. Kuberentes doesn't appear to have one.

[grobie]

I fully agree with @brian-brazil. Requiring a pull request to maintain an incomplete list of some of our thousands of users will create a lot of noise for people subscribed to the repo.

@caniszczyk Can you explain why the CNCF requires such file? What is your expectation how popular projects should deal with the PR noise? Why do you think a wiki page wouldn't work for that use case (I don't understand your comment regarding "grants you permission" in the other PR)? Thanks!

[beorn7]

We effectively have the file already: https://github.com/prometheus/docs/blob/master/content/index.html#L121-L157

Companies have usually been added there by a PR.

[juliusv]

@beorn7 The thing with that list is that it only contains companies who have explicitly asked us to put their logos there. It might be problematic for us to add logos without permission ourselves, but it's ok-er for us to add companies that are otherwise public about their Prometheus usage to a simple text file, where a logo is not involved. That would also allow us to list some of the much larger or more well-known companies, such as the New York Times, CERN, BNYMellon, etc.

[brancz]

I think we can start with a list like that as we don't have more information, but I actually really like the document that etcd has for this, as it highlights the volume of usage and how it's used.

https://github.com/coreos/etcd/blob/master/Documentation/production-users.md

[juliusv]

@brancz Nobody is going to keep such a detailed list up to date though...

[beorn7]

I don't see any problem with limiting the list of users to those who explicitly permitted their logo usage. We have by far enough for graduation anyway, and I daresay we are beyond the point where we have to brag about the number of big companies using Prometheus. On the contrary, bragging too much might create the impression we are desperately fishing for attention.

[juliusv]

Yeah, not related to graduation at all, but could still help convince some users if they see that several really big/reputable orgs are using it. And coolness factor. Not too much of a brag IMO.

[brancz]

@juliusv fair point on the maintenance.

[caniszczyk]

Listing adopters/users is a graduation requirement.

Also having an adopter send a PR to list them officially helps guide them through the contribution process too which can be thought of a plus. This may add to the backlog a bit when PRs come in but it's a net positive IMHO. It's up to the team on how this process works.

[juliusv]

@caniszczyk The graduation requirements say "(e.g., ADOPTERS.md or logos on the project website).". We already have the logos on the website, so this PR here is just an optional extra.

[caniszczyk]

fair enough but the spirit of that requirement should be an easy way for adopters/users to add them self to the list. If it's logos on the website, it should be easy for someone to add themselves there with instructions (if that makes sense)

…

On Tue, Feb 13, 2018 at 8:05 AM, Julius Volz ***@***.***> wrote: @caniszczyk <https://github.com/caniszczyk> The graduation requirements say "(e.g., ADOPTERS.md or logos on the project website).". We already have the logos on the website, so this PR here is just an optional extra. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#969 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAD5IfOlgN0gXjiM3XMGkmBYxEU4vr4Rks5tUZbFgaJpZM4SDca2> .

-- Cheers, Chris Aniszczyk http://aniszczyk.org +1 512 961 6719

[juliusv]

@caniszczyk Yeah, good idea to add instructions (we currently tell people to open a PR against https://github.com/prometheus/docs/blob/master/content/index.html), but could add a little "Want to see your logo here? ..." blurb.

I'm still for also adding the ADOPTERS.md file of course, which'll make this even easier and not require logo permissions.

[RichiH]

We're somewhat bikeshedding, but I can see everyone's point.

From a purely practical PoV, having hundreds or thousands of logos in the medium term will make the website load slowly, look fughly, and waste mobile user's data. Also, having one canonical way going forward would make sense.

@caniszczyk Notwithstanding this discussion, the graduation requirements could obviously be improved.

[beorn7]

Is this still relevant?

[brian-brazil]

We've graduated, so I'd say not.

[beorn7]

I'll close it then. @RichiH feel free to re-open if we are mistaken.