You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There should be white space around all headings and sub-headings.
The headings and subheadings should follow Wikipedia Style Title Case.
Along with this, I removed puncuation since that is not allowed per
Wikipedia, Microsoft, and other projects. This does remove some of the
charm or character of TOP like the exclamation mark at the end of one
of the headings.
Copy file name to clipboardExpand all lines: foundations/introduction/asking_for_help.md
+7-4Lines changed: 7 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,19 +3,20 @@
3
3
Along your programming journey, you will inevitably need to ask questions in an online coding community like ours, or in conversations with your colleagues. While asking questions may seem rather simple, in a programming environment it is essential to ask well formed questions with as much context as needed so you can get the most out of asking for help. In essence, “help others help you!” This lesson will provide you with the tools to effectively ask questions in communities such as our Discord chat, Stack Overflow, and in the workplace!
4
4
5
5
### Lesson Overview
6
+
6
7
This section contains a general overview of topics that you will learn in this lesson.
7
8
8
9
* Explain techniques for asking programming questions
9
10
* Explain and avoid qualities of “bad” questions
10
11
* Ask effective and well formed questions
11
12
12
-
### Tips for Getting The Best Help Possible
13
+
### Tips for Getting the Best Help Possible
13
14
14
-
#### <spanid="provide-code-knowledge-check">Always provide your code and the surrounding context.</span>
15
+
#### <spanid="provide-code-knowledge-check">Always Provide Your Code and the Surrounding Context</span>
15
16
16
17
You can ask theoretical, vague questions, but you’re going to get theoretical, vague answers that probably won't be helpful to you and cause frustration on both ends as you and the person helping you dance around the real issue. The only time code doesn’t need to be provided is if you are asking a purely conceptual question outside of a specific project or code snippet. Additionally, provide as much context as is necessary, and zero in on the specific problem, such as pointing people to a specific function or line number in your code so people can give you the most relevant answers and quickly assist you.
17
18
18
-
#### Ask about the problem at hand, not the solution itself.
19
+
#### Ask About the Problem at Hand, Not the Solution Itself
19
20
20
21
A lot of learners ask exactly how to approach a given task or assignment in this curriculum, such as the below:
21
22
@@ -29,7 +30,8 @@ In sharing your attempt, people know what you’ve tried and won’t suggest thi
29
30
30
31
Now, if you’re completely stuck with where to start, it’s completely fine to let people know that you’re stuck. Asking where you can start and what you can research to get on the right track empowers you to be able to resolve issues largely on your own in the future, and might even empower you to help others with the same issue later on. It is also recommended that you share your pseudo code so people can nudge you in the right direction or correct any misunderstandings you may have.
31
32
32
-
#### Don’t take asking for more context to heart!
33
+
#### Don’t Take Asking for More Context to Heart
34
+
33
35
People who volunteer in coding communities are here to help! But a question you may feel is coherent and “obvious” probably isn’t if you are being asked for more context. While something may seem "obvious" to a beginner, it's sometimes nowhere near "obvious" to an expert. An expert knows about many, many more situations that could cause an issue someone is experiencing, and would want to refrain from sending a learner down the wrong path. People take time out of their day to help, so make it as easy as possible for them to help you! There’s probably a good reason why they need more information, so trust their judgement and experience when they ask. Many people who help in coding chats are unpaid volunteers, and are in no way obligated to answer your query. But because they truly do want to help you, they will ask for more information when needed!
34
36
35
37
### Assignment
@@ -42,6 +44,7 @@ People who volunteer in coding communities are here to help! But a question you
42
44
</div>
43
45
44
46
### Knowledge Check
47
+
45
48
This section contains questions for you to check your understanding of this lesson on your own. If you’re having trouble answering a question, click it and review the material it links to.
46
49
47
50
* <aclass="knowledge-check-link"href="#provide-code-knowledge-check">Name at least one thing your question should always include.</a>
0 commit comments