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

Replace IRC with Slack in docs #13530

Merged
merged 1 commit into from
Sep 9, 2015
Merged

Conversation

goltermann
Copy link
Contributor

Just a find and replace.

@k8s-bot
Copy link

k8s-bot commented Sep 2, 2015

GCE e2e build/test passed for commit 527344b4b944b4ce3b6ba005a7fe4a9e3f8ff11f.

@k8s-bot
Copy link

k8s-bot commented Sep 2, 2015

GCE e2e build/test failed for commit 231252fa879a4e57769ed96f39e32b96659659b2.

@k8s-github-robot k8s-github-robot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Sep 2, 2015
@k8s-github-robot
Copy link

Labelling this PR as size/S

@yuvipanda
Copy link
Contributor

Are you guys really moving to Slack off IRC? :(

@goltermann
Copy link
Contributor Author

@k8s-bot please test this

@goltermann
Copy link
Contributor Author

@yuvipanda yes, looks like it. we tried it out, and most people liked the grouping of channels under one team, newer UI, and some of the notifications you can set up.

@yuvipanda
Copy link
Contributor

I see. Does this mean Slack is the new official place to get support for k8s?

@eparis
Copy link
Contributor

eparis commented Sep 3, 2015

I'll throw in a vote against, even though it may not/doesn't matter.

@mvdan
Copy link
Contributor

mvdan commented Sep 3, 2015

Another vote against. If connecting to IRC is too hard or the webchat is not enough, you can suggest things like irc cloud.

@bgrant0607
Copy link
Member

Voting against doesn't help unless you explain why.

The project is too big to have a single channel -- there's too much noise and cross-talk. I, for one, could rarely afford to pay attention it. We needed new channels for GKE vs. K8s, users vs. devs, SIGs, etc.

We either could create lots of new IRC channels, or choose a new medium. A number of people suggested Slack. For instance, the scalability SIG decided to use it. We tried it and liked it.

Among other issues, without threading, IRC is very hard to follow when there's more than one conversation. There's also no obvious way to search the logs. I don't know how to discover new IRC channels within a general topic area.

With respect to support, we'd like people to try stackoverflow/stackexchange first. Real-time support doesn't scale, and we also get a lot of FAQs. And, regardless of the communication medium, we need the community to help more with support.

@@ -76,7 +76,7 @@ These guidelines say *what* to do. See the Rationale section for *why*.

If you have a cluster partially working, but doing all the above steps seems like too much work,
we still want to hear from you. We suggest you write a blog post or a Gist, and we will link to it on our wiki page.
Just file an issue or chat us on IRC and one of the committers will link to it from the wiki.
Just file an issue or chat us on [Slack](https://github.com/docs/troubleshooting.md#slack) and one of the committers will link to it from the wiki.
Copy link
Member

Choose a reason for hiding this comment

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

Please use relative links everywhere. ../troubleshooting.md#slack in this case.

@bgrant0607
Copy link
Member

You need to run hack/update-generated-docs.sh.


The Kubernetes team hangs out on IRC at [`#google-containers`](https://botbot.me/freenode/google-containers/) on freenode. Feel free to come and ask any and all questions there.
The Kubernetes team hangs out on Slack in the `#kubernetes-users` channel. Slack requires registration, but the [Kubernetes](https://kubernetes.slack.com) team is open invitation to [join](http://slack.kubernetes.io). Feel free to come and ask any and all questions there.
Copy link
Member

Choose a reason for hiding this comment

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

It's not obvious which of these links the user should click on to join or participate. I suggest being more explicit, like register HERE and access the channels HERE.

@mvdan
Copy link
Contributor

mvdan commented Sep 3, 2015

Voting against doesn't help unless you explain why.

Good news is that they have an IRC gateway, but it still requires signing up and it's messy when people send stuff other than text e.g. images or files. Also the whole mentioning via nick or @nick doesn't work well when using an IRC client.

The project is too big to have a single channel -- there's too much noise and cross-talk. I, for one, could rarely afford to pay attention it. We needed new channels for GKE vs. K8s, users vs. devs, SIGs, etc.

Agreed on multiple channels, which works in either IRC or Slack.

Among other issues, without threading, IRC is very hard to follow when there's more than one conversation.

Slack doesn't have threading, at least as far as I can see.

There's also no obvious way to search the logs.

You use botbot.me, which makes this easy.

I don't know how to discover new IRC channels within a general topic area.

Freenode doesn't offer this service directly but some third parties do:

Also, regarding notifications, you can have those set up by being connected all the time. You don't need to be connected directly, you can use a third party service like IRC Cloud which then can push notifications to your devices.

@goltermann
Copy link
Contributor Author

I've enabled IRC gateway from Slack for the Kubernetes team. If you want to try it out, https://kubernetes.slack.com/account/gateways should give you the details you need.

@bgrant0607
Copy link
Member

And our self-service signup page is http://slack.k8s.io

@goltermann goltermann force-pushed the docs branch 2 times, most recently from 4a95a5b to f8b9bcc Compare September 4, 2015 00:25
@k8s-bot
Copy link

k8s-bot commented Sep 4, 2015

GCE e2e build/test failed for commit 4a95a5bc93f1f50840e17bc1154c5fba533241be.

@k8s-bot
Copy link

k8s-bot commented Sep 4, 2015

GCE e2e build/test failed for commit f8b9bcc794be7d8d1e9085586975ee2d45b5968c.

@goltermann
Copy link
Contributor Author

@k8s-bot test this again

(just barely timed out after passing all E2E tests)

@k8s-bot
Copy link

k8s-bot commented Sep 4, 2015

GCE e2e build/test passed for commit f8b9bcc794be7d8d1e9085586975ee2d45b5968c.

@j3ffml j3ffml added lgtm "Looks good to me", indicates that a PR is ready to be merged. kind/documentation Categorizes issue or PR as related to documentation. and removed lgtm "Looks good to me", indicates that a PR is ready to be merged. labels Sep 7, 2015
@k8s-bot
Copy link

k8s-bot commented Sep 8, 2015

GCE e2e build/test passed for commit f0dbf1cca0f94cca82142ef6da62fbe4d6a70ded.

@k8s-bot
Copy link

k8s-bot commented Sep 8, 2015

GCE e2e build/test passed for commit bec4c10.

@j3ffml j3ffml added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Sep 9, 2015
@k8s-github-robot
Copy link

@k8s-bot test this [submit-queue is verifying that this PR is safe to merge]

@k8s-bot
Copy link

k8s-bot commented Sep 9, 2015

GCE e2e build/test passed for commit bec4c10.

@k8s-github-robot
Copy link

Automatic merge from SubmitQueue

k8s-github-robot pushed a commit that referenced this pull request Sep 9, 2015
Auto commit by PR queue bot
@k8s-github-robot k8s-github-robot merged commit 891cef4 into kubernetes:master Sep 9, 2015
@goltermann goltermann deleted the docs branch March 3, 2016 21:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants