Jaycar-Electronics / Duinotech-Starter-Kit-For-Arduino

Arduino Start Kit Projects
GNU General Public License v3.0
29 stars 13 forks source link

how to confuse a n00b #4

Open terentz opened 4 years ago

terentz commented 4 years ago

You've laid out the second project (potentiometer) such that the only thing it has pictorially in common with the first project (LED) is the Arduino itself and the breadboard, despite the fact that the second project is explicitly an elaboration of the first. Once one gets to plugging the black jumper wire from the potentiometer into the Arduino, and finds oneself instructed to use the same port as the black jumper wire from the LED, which clearly won't be accommodated, one's anxiety might thus start to play on oneself, and might feel that one has been dropped on a road to hell, albeit paved with the best of intentions, I don't doubt. Nevertheless, frustration ensues, and the effort you've exerted has thwarted its own usefulness. To overcome this minor tragedy, please correct your diagram by including all necessary components and thus removing the contradiction that stirs the stress of ambiguity in the mind of the poor, innocent n00b (who is your customer, and paid for a product, not a headache.) Poor documentation is the scourge of programmers. Don't be that guy!

Jaycar-Electronics commented 4 years ago

changed it a bit in https://github.com/Jaycar-Electronics/Arduino-Starter-Kit/commit/bd52bf5e3611a1a85278165d5bb7a8a9ca5ff19a, do you think this works? or how would you put it.