Fork me on GitHub
#community-development
<
2023-04-09
>
nottmey18:04:36

Hello, wouldn’t it be great to have badges in the documentation of Clojure packages? I think it would be convenient to click on them and be directed to the appropriate channel on this Slack workspace. What obstacles are preventing maintainers from providing this badge?

👍 1
1
nottmey18:04:41

Slack example is from this (random) package: https://github.com/brigadecore/brigade-foundations

seancorfield21:04:08

No obstacles. I suspect many projects already have prose that talks about channels on Slack for support but perhaps maintainers aren't aware of something that auto-generates a "badge" icon for the link? (I wasn't) One potential downside is if someone isn't already a member of this Slack and clicked on a link to a channel, I don't think that gives them an option to signup so it might seem like a dead end?

seancorfield21:04:09

I just added Slack badges to my four top OSS projects -- so thank you for the nudge @U3ZG4CAF8!

🥳 4
nottmey16:04:46

Ah interesting! Awesome that you directly tried it out 😊 Oh I see, yes, the onboarding experience for people without an account isn’t great. 😞 Maybe there are invite links that redirect to a channel though, I’ll have look. :thinking_face:

nottmey17:04:46

Meh, there doesn’t seem to be feature on https://clojurians.slack.com/join/shared_invite/zt-1sn68vi9d-qdfDzonsBuZpmbchBcfOBQ#/shared-invite/email to redirect to a channel 😞 What I found out though, that this link structure may be better for the badge, because it redirects people to their preferred slack client: https://clojurians.slack.com/app_redirect?channel=community-development (Docs: https://api.slack.com/reference/deep-linking)

seancorfield17:04:33

Yeah, Slack isn't designed to be "self-service" -- it's intended to be used by companies that explicitly invite (or proactively signup) new members. That redirect link is more readable too... I'll update my projects, next time I'm editing them.

👌 1
nottmey17:04:13

I prepared 2 badges, feel free to use them:

[![Join Slack]()
(https://img.shields.io/badge/join-clojurians-5881D8?logo=slack&amp;style=flat, http://clojurians.net/)
[![Join Channel]()
(https://img.shields.io/badge/channel-community--development-online?logo=slack&amp;logoColor=white&amp;style=flat, https://clojurians.slack.com/app_redirect?channel=community-development) (For anyone reading, see shield options here: https://shields.io/: available styles plastic, flat, flat-square, for-the-badge, social; for changing the label replace community--development with your channel name and use -- for dashes, _ for space, and __ for underscores)

gratitude 9
👍 6
💯 6
2