-
Notifications
You must be signed in to change notification settings - Fork 183
docs(slack): fix broken Slack links and improve onboarding #714
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
Open
abhishek-8081
wants to merge
1
commit into
kubeedge:master
Choose a base branch
from
abhishek-8081:patch-2
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,23 +1,59 @@ | ||
| --- | ||
| title: How to Join KubeEdge Slack | ||
| title: How to Join KubeEdge Slack | ||
| sidebar_position: 7 | ||
| --- | ||
|
|
||
| # Slack | ||
|
|
||
| Connect with the KubeEdge community to ask questions, share ideas, and stay updated on project developments. | ||
|
|
||
| ## How to Join | ||
|
|
||
| ### Step 1: Join CNCF Slack Workspace | ||
| 1. Visit **[https://slack.cncf.io](https://slack.cncf.io)** | ||
| 2. Enter your email address | ||
| 3. Check your email and click the verification link | ||
| 4. Create your Slack profile | ||
| 5. Complete the workspace setup | ||
|
|
||
| ### Step 2: Access KubeEdge Channels | ||
| Once you're in the CNCF Slack workspace: | ||
|
|
||
| - You can **search for "kubeedge"** in the Slack search bar to find all channels | ||
| - Or use the **direct links** below (for existing Slack members) | ||
|
|
||
| ## KubeEdge Channel Directory | ||
|
|
||
| ### General & Announcements | ||
| - [#kubeedge](https://cloud-native.slack.com/archives/C066UJZJKQE) – General discussion and community questions | ||
| - [#kubeedge-announcement](https://app.slack.com/client/T08PSQ7BQ/C06BCA5MR5Y) – Official project updates and announcements | ||
|
|
||
| ### Development & Technical | ||
| - [#kubeedge-dev](https://app.slack.com/client/T08PSQ7BQ/C06C13NGR0Q) – Development discussions and technical questions | ||
| - [#kubeedge-dashboard](https://app.slack.com/client/T08PSQ7BQ/C066LNA3015) – Dashboard-related development and issues | ||
| - [#kubeedge-docs](https://app.slack.com/client/T08PSQ7BQ/C06BCA5V1LJ) – Documentation improvements and discussions | ||
|
|
||
| ### Special Interest Groups (SIGs) | ||
| - [#kubeedge-sig-ai](https://app.slack.com/client/T08PSQ7BQ/C06BQURDQQ1) – AI/ML workloads on edge computing | ||
| - [#kubeedge-sig-device-iot](https://app.slack.com/client/T08PSQ7BQ/C06BC6VQHFD) – IoT device integration and management | ||
| - [#kubeedge-sig-robotics](https://cloud-native.slack.com/archives/C066LNMUME3) – Robotics applications and use cases | ||
| - [#kubeedge-sig-security](https://app.slack.com/client/T08PSQ7BQ/C06C13NN1UG) – Security best practices and discussions | ||
| - [#kubeedge-sig-mec](https://app.slack.com/client/T08PSQ7BQ/C06B5LRV3B8) – Mobile Edge Computing (MEC) topics | ||
|
|
||
| ## Tips for New Contributors | ||
| - **Start here:** #kubeedge for general questions | ||
| - **Technical help:** #kubeedge-dev for development topics | ||
| - **Documentation:** #kubeedge-docs for doc improvements | ||
|
|
||
| **Best Practices:** | ||
| - Search before asking to avoid duplicate questions | ||
| - Use threads to keep conversations organized | ||
| - Provide full context when asking for help (error messages, versions, etc.) | ||
| - Be patient—community members are in multiple time zones | ||
|
|
||
| ## Troubleshooting | ||
| If you can't access a direct link above: | ||
| - Join via [slack.cncf.io](https://slack.cncf.io) and search the channel name | ||
| - Ask in **#kubeedge** if you need help finding a channel | ||
|
|
||
| If you have any questions you are always welcome in KubeEdge channels on the CNCF Slack: | ||
|
|
||
| - Navigate to https://slack.cncf.io/ and create your Slack account. | ||
| - Find us in one of the following channels and ask your question: | ||
| - [#kubeedge](https://cloud-native.slack.com/archives/C066UJZJKQE) | ||
| - [#kubeedge-announcement](https://cloud-native.slack.com/archives/C067DTAF4Q1) | ||
| - [#kubeedge-dev](https://cloud-native.slack.com/archives/C06718TB6F4) | ||
| - [#kubeedge-dashboard](https://cloud-native.slack.com/archives/C066LNA3015) | ||
| - [#kubeedge-docs](https://cloud-native.slack.com/archives/C06718RDHCJ) | ||
| - [#kubeedge-sig-ai](https://cloud-native.slack.com/archives/C067DTGJJM7) | ||
| - [#kubeedge-sig-device-iot](https://cloud-native.slack.com/archives/C067Q8J3KTJ) | ||
| - [#kubeedge-sig-robotics](https://cloud-native.slack.com/archives/C066LNMUME3) | ||
| - [#kubeedge-sig-security](https://cloud-native.slack.com/archives/C067Q8LC3T2) | ||
| - [#kubeedge-sig-mec](https://cloud-native.slack.com/archives/C06716458P5) | ||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There are a couple of issues with the channel directory list:
Inconsistent URL format: The PR description correctly identifies that
app.slack.com/client/...URLs are problematic for new users, yet many of the new links use this format. For a better user experience and consistency, all channel links should use thehttps://cloud-native.slack.com/archives/CHANNEL_IDformat. This format is more web-friendly as it opens in the browser.Inconsistent formatting: The line for
#kubeedge-announcementis missing the trailing two spaces for a hard line break, which is used on other similar lines.I've provided a suggestion that fixes both issues by updating the URLs to the
cloud-native.slack.com/archives/format and ensuring consistent formatting.