Skip to content

Instantly share code, notes, and snippets.

@thenickreynolds
Last active September 25, 2022 03:53
Show Gist options
  • Save thenickreynolds/227e391b9cee8511d34379e3ec39187b to your computer and use it in GitHub Desktop.
Save thenickreynolds/227e391b9cee8511d34379e3ec39187b to your computer and use it in GitHub Desktop.
Article: How to Ask Great Questions

One aspect of being a successful engineer is asking great questions! We shouldn't be afraid to ask questions (they are critical to how we learn and grow) but, if you follow these steps, you'll ensure the questions you ask are high quality and you can learn the most from the answers you get.

When

Ask when you've gotten stuck for a while (e.g. 20 minutes) and you're not making progress or if you've been spinning your wheels for a while.

Before you do

Make sure you've searched for the answer in the documentation, Stack Overflow, in channels (on Slack or Discord), etc.

How

Get straight to the point (skip the hello) and ask in the right place (where are the experts for this).

Share

  1. A smart, precise title that describes the key aspects
  2. What outcome you're trying to achieve not just the problem you're seeing
  3. What you've tried, what you know
  4. Exact context - full error logs, PRs, platform information, etc , don't skimp and have to go back-and-forth
  5. Make it easy to reply - create thread

After

Ask yourself how you could have solved this yourself and how you'll change the way you approach problems next time. Leave the answer for the next person - make it clear where the answer is (update your original message), refactor code, add documentation, improve error messages, etc.

Read more

This is a super compressed version of this great read: http://www.catb.org/~esr/faqs/smart-questions.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment