Skip to content

Commit

Permalink
admin/appendices: tweak text
Browse files Browse the repository at this point in the history
  • Loading branch information
damithc committed Dec 28, 2017
1 parent 7c75656 commit 6d7a69f
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 4 deletions.
14 changes: 10 additions & 4 deletions admin/appendixD-help.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

**We want to move you away from 'hand holding' and make you learn how to solve problems on your own.** This is a vital survival skill in the industry and it needs practice.

Whether it is a technical problem %%(e.g. error when using the IDE)%% or a doubt about a concept %%(e.g. what is the difference between scripted testing and exploratory testing?)%% **we the teaching team are happy to work _with_ you when you look for a solution/answer, but we do not do it _for_ you.** We discourage unconditional direct help from tutors because we want you to learn to help yourself. Yes, we believe in ‘tough love’:stuck_out_tongue_closed_eyes:.
Whether it is a technical problem %%(e.g. error when using the IDE)%% or a doubt about a concept %%(e.g. what is the difference between scripted testing and exploratory testing?) %% **we the teaching team are happy to work _with_ you when you look for a solution/answer, but we do not do it _for_ you.** We discourage unconditional direct help from tutors because we want you to learn to help yourself. Yes, we believe in ‘tough love’:stuck_out_tongue_closed_eyes:.

The question you should always ask yourself is, 'how do I solve this problem if the lecturer/tutors are not around to help me?' 

Expand Down Expand Up @@ -43,13 +43,19 @@ Instead, here are some things you can do:
Here are some tips for posting help request:
* PLEASE search for existing answers before you post your question in those public forums; You don't want to appear as a 'clueless' or 'too lazy to do your research' person in a public forum.
* Learn to isolate the problem. "My code doesn't work" isn't going to help even if you post the whole code online. Others don't have time to go through all of your code. Isolate the part that doesn't work and strip it down to the bare minimum that is enough reproduce the error. Sometimes, this process actually helps you to figure out the problem yourself. If not, at least it increases the chance of someone else being able to help you.
<tip-box type="tip">
How to isolate problematic code? Delete code (one bit at a time) that is confirmed as not related to the problem. Do that until you can still reproduce the problem with the least amount of code remaining.
<tip-box>

:bulb: How to isolate problematic code? Delete code (one bit at a time) that is confirmed as not related to the problem. Do that until you can still reproduce the problem with the least amount of code remaining.

</tip-box>

* Generalize the problem. "How to write tasks to a text file using Java" is too specific to what you are working on. You are more likely to find help if you post a thread called (or search for) "How to write to a file using Java".
* Explain well. Conversations via online forums take time. If you post everything that is relevant to your problem, your chances of getting an answer in the first try is higher. If others have to ask you more questions before they can help you, it will take longer. But this doesn't mean you dump too much information into the thread either.
<tip-box type="tip">Know what these stand for: **RTFM**, **STFW**, **GIYF**</tip-box>
<tip-box>

:bulb: Know what these stand for: **RTFM**, **STFW**, **GIYF**

</tip-box>

* **Talk to the lecturer** before or after the lecture. The lecturer will be at the lecture venue from 30 minutes before the start of the lecture.

Expand Down
Binary file modified admin/images/PrDetails.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified diagrams/admin/prDetails.pptx
Binary file not shown.

0 comments on commit 6d7a69f

Please sign in to comment.