Should open source projects keep "how do I" questions out of GitHub issues?

Kaustubh Katdare
@kaustubh-katdare
Published: Nov 15, 2026
Views: 13

I've never maintained an open source project. So treat this as an outsider's view, and tell me where it's wrong.

From the outside, GitHub issues seem to do three jobs at once: bug reports, feature requests and "how do I install this on Windows?" Maintainers answer the same questions again and again.

After reading what maintainers and the Open Source Guides recommend, this is the split I'd try:

  • Confirmed bugs and tracked work stay in issues.

  • Settled answers go in the docs.

  • How-to questions, ideas and show-and-tell go to a community.

  • The best community answers move into the docs.

Does that actually take load off maintainers? Or is it just one more place to check?

jatra.club How to Build an Open Source Community How to build an open source community around your project: route questions to the right place, seed answers, grow contributors and get found on Google.

Welcome, guest

Join Jatra Community to reply, ask questions, and participate in conversations.

Jatra Community powered by Jatra Community Platform