Skip to main content
GitHub Discussions gives projects a structured, searchable place for community engagement that complements issues and pull requests. Selecting the right discussion category keeps conversations organized, helps contributors find relevant threads, and enables maintainers to triage and act on community feedback faster. Below is a concise overview of each common Discussion category, its purpose, and practical examples of when to use it.

Category details and examples

  • Announcements
    Use Announcements for official, one-way communication from maintainers. Threads are often locked to prevent replies and keep the feed focused.
    • Examples: release notes, major policy updates, security advisories.
  • General
    A flexible area for community conversation that doesn’t belong in other categories.
    • Examples: welcome messages, informal discussions, community coordination.
  • Ideas
    Use this category to propose changes or gather preliminary feedback on new directions.
    • Examples: feature requests, UI redesign concepts, experimental approaches.
  • Polls
    Create quick, vote-driven polls to gauge community preference or consensus.
    • Examples: choosing the next feature to prioritize, selecting branding elements.
  • Q&A
    Dedicated to troubleshooting and technical help. Replies can be marked as the accepted solution to guide future readers.
    • Examples: configuration help, debugging steps, platform-specific guidance.
  • Show and Tell
    Celebrate and share creative uses of the project to inspire others.
    • Examples: side projects, integrations, real-world case studies.
Use categories consistently and include clear, descriptive titles and tags. This improves discoverability, speeds up triage, and helps future contributors find answers faster.

Best practices for maintainers and contributors

  • Create clear category descriptions so users know where to post.
  • Encourage good titles and tags—these improve search results and help maintainers prioritize.
  • Lock the Announcements category to preserve authoritative updates.
  • Use the Q&A category’s accepted answer feature to surface verified solutions.
  • Regularly review the Ideas and Polls categories to gather community input for roadmaps.
In summary, using the correct Discussion categories keeps your community organized, surfaces useful ideas and solutions, and enables maintainers to prioritize and act on feedback efficiently.

Watch Video