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

Improve Slack join instructions for better readability #1641

Conversation

ThatsIvan
Copy link
Contributor

This PR updates the Slack section of the documentation to clarify the process for joining the cert-manager Slack channels. The previous wording was potentially misleading, as users must first join the Kubernetes Slack workspace before they can access the cert-manager-specific channels. The updated text provides step-by-step guidance and includes a link to request an invitation to Kubernetes Slack, making the process clearer for new members who want to contribute.

@cert-manager-prow cert-manager-prow bot added dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Feb 6, 2025
Copy link

netlify bot commented Feb 6, 2025

Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 350d3ac
🔍 Latest deploy log https://app.netlify.com/sites/cert-manager/deploys/67a4bb719a896a000795e570
😎 Deploy Preview https://deploy-preview-1641--cert-manager.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@ThatsIvan ThatsIvan force-pushed the ivanmanzi/improve-contributing-readme-md branch from b411cdc to cdeed81 Compare February 6, 2025 08:48
@cert-manager-prow cert-manager-prow bot added dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. and removed dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. labels Feb 6, 2025
Copy link
Member

@SgtCoDFish SgtCoDFish left a comment

Choose a reason for hiding this comment

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

Thanks so much for this, love these kinds of changes! Got a couple of small suggestions, what do you think?

@@ -60,9 +60,15 @@ before the meeting. The meeting chair will try to get to everything that was on
We try to record these meetings and put them on YouTube so they can be checked later – if you don't want to appear on video please keep
your camera off!

## Slack
## Slack Community
Copy link
Member

Choose a reason for hiding this comment

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

suggestion: Changing this heading changes the link; I often link people to https://cert-manager.io/docs/contributing/#slack and so changing the link would be a "breaking" change.

Could we leave the heading as it is, and add a comment explaining that we don't want it to change?

Suggested change
## Slack Community
## Slack
{/* NOTE: We share the link to this heading quite often in various places including slide decks, documentation and meeting notes. Please ensure that the `#slack` link is preserved! */}

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is completed @SgtCoDFish , kindly review again.

@cert-manager-prow cert-manager-prow bot added dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. and removed dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. labels Feb 6, 2025
@ThatsIvan ThatsIvan force-pushed the ivanmanzi/improve-contributing-readme-md branch from e64f790 to daa3f8e Compare February 6, 2025 12:06
@@ -60,9 +60,16 @@ before the meeting. The meeting chair will try to get to everything that was on
We try to record these meetings and put them on YouTube so they can be checked later – if you don't want to appear on video please keep
your camera off!

[comment]: <> (Changing this heading will break the reference link at https://cert-manager.io/docs/contributing/#slack, so avoid modifying it.)
Copy link
Member

Choose a reason for hiding this comment

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

Adding comments in these docs is a bit weird; there's a guide here: https://github.com/cert-manager/website/?tab=readme-ov-file#task-adding-a-comment-in-documentation

@ThatsIvan ThatsIvan force-pushed the ivanmanzi/improve-contributing-readme-md branch from 4c1b0f3 to 84ae72d Compare February 6, 2025 13:22
Signed-off-by: ThatsIvan <ivanmanzix@gmail.com>
Signed-off-by: ThatsIvan <ivanmanzix@gmail.com>
Signed-off-by: ThatsIvan <ivanmanzix@gmail.com>
Signed-off-by: ThatsIvan <ivanmanzix@gmail.com>
@ThatsIvan ThatsIvan force-pushed the ivanmanzi/improve-contributing-readme-md branch from 84ae72d to 350d3ac Compare February 6, 2025 13:38
@cert-manager-prow cert-manager-prow bot added dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. and removed dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. labels Feb 6, 2025
Copy link
Member

@SgtCoDFish SgtCoDFish left a comment

Choose a reason for hiding this comment

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

/lgtm
/approve

Thanks for this! 🚀

@cert-manager-prow cert-manager-prow bot added the lgtm Indicates that a PR is ready to be merged. label Feb 6, 2025
@cert-manager-prow
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: SgtCoDFish

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@cert-manager-prow cert-manager-prow bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 6, 2025
@SgtCoDFish SgtCoDFish merged commit 4a44503 into cert-manager:master Feb 6, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. lgtm 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.

2 participants