Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions src/blog/2025/10/tools-catalog-github-discussions.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,19 +45,19 @@ GitHub Discussions may not be your ideal tool if you have constraints such as:

## Consideration: User Accounts

One limitations of GitHub Discussions is account management.
One limitation of GitHub Discussions is account management.

If you want to be able to email everybody in your community, GitHub Discussions does not allow you to get email addresses unless participants have opted to share them publicly.

If you want to let your community participate in GitHub Discussions using the same account as your SaaS, PaaS, or user accounts then you would need to use social login with OAuth in order to correlate user accounts.

## Consideration: Scoping Your Community Discussions

Typically on GitHub, you'll have a one to many relationship of an **organization** to **repositories**. You can enable GitHub Discussions on each individual repository but you can only have one for the organization overall.
Typically on GitHub, you'll have a one-to-many relationship of an **organization** to **repositories**. You can enable GitHub Discussions on each individual repository but you can only have one for the organization overall.

This can be a source of confusion for your community if discussions are happening in multiple places unless the repositories are for projects that are very distinct.

## Recommendation: A Community Repos for Your Organization
## Recommendation: A Community Repo for Your Organization

A recommended approach to setting up discussions for your technical community.

Expand All @@ -80,7 +80,7 @@ See the GitHub Docs:

Once you've set up your community repository, it's important to consolidate discussions to avoid confusion.

Check for any other repositories with discusisons enabled but inactive or not used much. You should disable them to avoid confusing your community on where to find activity and get responses.
Check for any other repositories with discussions enabled but inactive or not used much. You should disable them to avoid confusing your community on where to find activity and get responses.

## Recommendation: Customize Discussion Categories

Expand All @@ -93,13 +93,13 @@ For many organizations this may be a fine place to start. If you have folks in y

For example, with the DevRel Foundation we are part of one community, but somebody interested in the [Tools Catalog](https://github.com/DevRel-Foundation/wg-resource-aggregation/discussions/categories/tools-catalog) may not have any interest in the [Persona Library](https://github.com/DevRel-Foundation/wg-resource-aggregation/discussions/categories/persona-library). Using separate categories would be a way of offering a filter when projects are unrelated.

You might consider using a separate category for each repository, so while there is a single common community discussion groups, each repository can still carve off its own focused area.
You might consider using a separate category for each repository, so while there is a single common community discussion group, each repository can still carve off its own focused area.

## Recommendation: Use Pinned Discussion Messages Effectively

Create a message and call it something like "Welcome! How-to Get Started Here". Include a succinct introduction so that when somebody first finds your GitHub Discussions they know where to begin.

![pinned messages for github discusions](/images/blog/2025/tools-catalog-discussions-pinned-messages.png)
![pinned messages for GitHub Discussions](/images/blog/2025/tools-catalog-discussions-pinned-messages.png)

In your welcome, make sure to cover:
- [ ] explain what the community is
Expand Down