Website: Hard to find community resources

[ewilderj]

I noticed a flattening in the number of people joining the Kubeflow mailing list, so I went to the web site to see how discoverable it was. What I found is that apart from directions to join the Github org, I couldn't easily find directions to either the mailing list, or the Slack channel. Anywhere "community" is mentioned, these resources ought to be reachable, and also they ought to be reachable from the front page too.

[tlkh]

Hi @ewilderj, I’m wondering if the Slack channel should be open to all. Currently, it seems like only emails from a few whitelisted domains (eg google.com) are allowed to register.

[ewilderj]

@tlkh it depends on which link is given, there's a link which enables anyone to get in... but a bare "kubeflow.slack.com" will go to the whitelisted page, for sure.

[ewilderj]

This link will work as an open invitation: https://join.slack.com/t/kubeflow/shared_invite/enQtMjgyMzMxNDgyMTQ5LWUwMTIxNmZlZTk2NGU0MmFiNDE4YWJiMzFiOGNkZGZjZmRlNTExNmUwMmQ2NzMwYzk5YzQxOWQyODBlZGY2OTg

[ewilderj]

Here's some of the community content that would be good to reflect on the web site:
https://github.com/kubeflow/community/blob/master/README.md

[sarahmaddox]

/assign

[sarahmaddox]

I'll take this on. Here are some suggestions for discussion:

• On the front page, there's a "Community" section right at the bottom. I propose to add a "Contribute" button at the top too, next to the existing "Get Started" button, pointing to the contributing page in the docs:

• Add a prominent link on the existing contributing page in the docs, pointing to the community page in the docs.

• Expand the info on the existing community page in the docs, and check it has everything that's in the GitHub community README.

• Minimise the info in the GitHub community README so that it welcomes people and points them to the docs for info. (Otherwise we'll find ourselves being inconsistent between the docs and the README.)

• Also add more about contributing to the docs.

How does that sound?

[sarahmaddox]

/area docs

[ewilderj]

sgtm! thanks for taking this on!