Go Down

Topic: Loop Back Test - Sticky? (Read 35 times) previous topic - next topic

PaulS

Quote
How's this for the introduction...

Needs a comma between "host computer" and  "hardware driver". It is testing all 4 items.

Coding Badly


tytower


I tried the procedure and had no difficulty following it.


Excellent!  Thank you.

Quote
The slight change I wanted to suggest was that some of the text in step 8 should be removed


Nope.  Not going to happen.  My Tech-Com II professor stated repeatedly: You tell it to them three times.  You tell them what you are going to tell them in the introduction.  Then you tell them in the body.  Then you tell them what you told them in the conclusion.  After working in technical support for a few years, I strongly agree.  Some people get it the first time they read something.  Some people barely get it the third time they read something.  Troubleshooting instructions need to be written for the latter group; lots of repetition.

Quote
and instead there should be a short introduction saying why you would do the test and what it would achieve


I agree.  It needs an introduction / cover.

Quote
Suggested text at the start (removing equivalent text in point 8 );
Quote
The loopback test will prove that your host computer hardware driver, USB cable, and USB to serial converter are all working.
Try the loopback test after you first install the system or if you cannot upload sketches.


Is it necessary to perform a loop-back test after first installing the system?



So treat everybody like dummies because there might be one or two in a dozen !
How did the dummies get into your professors class?
When I went to uni it was stay up or get out
Governments should do what they were designed to do only.
Manage the larger issues best done by Government.
My Family and my Property are no

draythomp

Not everyone that needs repetition is a dummy.  Some folks read this board in their second or third language.  Some folks use google translate to read it.  Some folks are beginners at everything electronic.  Like it or not, repetition works.  It gives the person a second chance to hear it, it gives the translator a new version to try and screw up differently and it helps to reinforce information.

Besides, being snide doesn't help.
Trying to keep my house under control http://www.desert-home.com/

Coding Badly


The current state of the introduction...
http://arduino.cc/forum/index.php/topic,67509.msg564416.html#msg564416

We have one use-case.

Should the sticky include references to example / related topics?  Some examples...
http://arduino.cc/forum/index.php/topic,75418.msg568935.html#msg568935
http://arduino.cc/forum/index.php/topic,75651.0.html

Any more comments before I change the sticky?

Go Up