spam-reports

nottmey 2023-04-09T18:38:36.107409Z

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
nottmey 2023-04-10T16:39:46.314509Z

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. πŸ€”

nottmey 2023-04-10T17:04:46.737129Z

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)

seancorfield 2023-04-10T17:18:33.188809Z

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
nottmey 2023-04-10T17:44:13.634609Z

I prepared 2 badges, feel free to use them:

[![Join Slack]()
(https://img.shields.io/badge/join-clojurians-5881D8?logo=slack&style=flat, http://clojurians.net/)
[![Join Channel]()
(https://img.shields.io/badge/channel-community--development-online?logo=slack&logoColor=white&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)

πŸ‘ 4
πŸ‘πŸ» 1
πŸ’― 4
6
nottmey 2023-04-09T18:39:41.303829Z

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

nottmey 2023-04-09T18:40:39.137259Z

Another (random) example: https://github.com/Auto-DL/auto-dl.github.io

seancorfield 2023-04-09T21:11:08.024999Z

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?

seancorfield 2023-04-09T21:27:09.506189Z

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

πŸ₯³ 3