Skip to content

Asking for help

Everyone needs help sometimes, especially when they are new to a project or to a language. There is no shame in asking. The real problem is usually not that you ask, but how you ask. A well-written question gets a fast and helpful answer. A vague or demanding question often gets ignored.

Think of it this way: the person reading your message cannot see your screen, your brain, or the hours you already spent. All they have is your words. So your job is to make it easy for them to understand what you need.

Ask in the right place

Before you write anything, check where the project expects questions. Many projects ask you to open an issue, use Discussions, or join a chat. Asking in the wrong place wastes everyone's time.

Do a little research first

Try to solve the problem yourself before asking. Search the docs, search existing issues, and read the relevant code. Then, when you ask, you can say what you already tried. This shows respect for the maintainer's time and usually gets you a better answer.

How to phrase a good question

A good question has three parts:

  1. What you are trying to do.
  2. What you already tried.
  3. Where exactly you are stuck.

Avoid blaming the code or the project. Instead of saying "your code is broken", say what you expected and what actually happened.

Bad: "This code is broken, help me."

Good: "I'm trying to use the load() function, but it returns null for my file. I checked the path and it exists. Could you explain what I'm missing?"

Ready-to-use phrases

Polite openers:

"Could you help me understand this?"

"I'd like to get some guidance on this, if you have a moment."

Giving context:

"I've already tried X and Y, but I'm still stuck on Z."

"I'm new to this part of the codebase, so I might be missing something obvious."

Asking a follow-up:

"Thanks for the hint — could you give me one more example so I can see how it fits together?"

A simple rule

Treat the person you ask as a busy volunteer, not as tech support. Make their job easy by being specific and showing your own effort. A clear question is a kindness, and it usually brings a quick and useful answer.