Pages: [1]   Go Down
Author Topic: Any chance of getting this tutorial changed?  (Read 1735 times)
0 Members and 1 Guest are viewing this topic.
Manchester (England England)
Offline Offline
Brattain Member
*****
Karma: 637
Posts: 34580
Solder is electric glue
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

This page:-
http://www.arduino.cc/en/Tutorial/BlinkingLED
Is a constant trap for beginners, it says:-

Quote
We have added a 1K resistor to pin 13, what allows the immediate connection of a LED between that pin and ground.

This hasn't been true for years, it tricks beginners into thinking it is true, not wholly unreasonable as it has the air of officialdom about it. But it also make other think you can do it with all pins, silly I know but there it is.
Just a change saying:-

You need to add a current limiting resistor to drive an LED from any Arduino pin

would surly do it.
Logged

Global Moderator
Boston area, metrowest
Offline Offline
Brattain Member
*****
Karma: 548
Posts: 27372
Author of "Arduino for Teens". Available for Design & Build services. Now with Unlimited Eagle board sizes!
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

I've e-mailed Massimo about it.
Logged

Designing & building electrical circuits for over 25 years. Check out the ATMega1284P based Bobuino and other '328P & '1284P creations & offerings at  www.crossroadsfencing.com/BobuinoRev17.
Arduino for Teens available at Amazon.com.

Global Moderator
Offline Offline
Brattain Member
*****
Karma: 504
Posts: 19095
Lua rocks!
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

If you don't mind me suggesting it, it's ridiculous that such a trivial sketch has as many lines of comments as the code. In particular, credits, date, "based on an original" and a Copyleft assertion.

http://en.wikipedia.org/wiki/Copyleft

It blinks an LED! You don't need to have to require anyone that "modifies or extends" it to also copyleft their work.

Also the comments mention using pin 13 "because it has a resistor attached to it" - you need to change or delete that.

BTW this page:

http://arduino.cc/en/Tutorial/Blink

... doesn't bang on about Copyleft. In fact it says "This example code is in the public domain.".
Logged


Topsham, Vermont USA
Offline Offline
Edison Member
*
Karma: 33
Posts: 1926
... in The Woods In Vermont
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Hello Admin!! 

This wrong information is being picked up by Newbies and publications.

I just reviewed a University course and this same misconception is in their lab handouts!! 

It's On Arduino It Must Be Right!..    PLEASE??

Logged

Regards, Terry King terry@yourduino.com  - Check great prices, devices and Arduino-related boards at http://YourDuino.com
HOW-TO: http://ArduinoInfo.Info

nr Bundaberg, Australia
Offline Offline
Tesla Member
***
Karma: 129
Posts: 8602
Scattered showers my arse -- Noah, 2348BC.
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

And not to mention the infamous "cap on shift register clock pin".

I imagine they have their hands full with the new boards at present, and when they are released the docs will be even more out of whack.

I know we've said before that more detailed docs will confuse beginners, but constantly referring to schematics and source code is not the way to go either.

______
Rob
Logged

Rob Gray aka the GRAYnomad www.robgray.com

Topsham, Vermont USA
Offline Offline
Edison Member
*
Karma: 33
Posts: 1926
... in The Woods In Vermont
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Hi Rob,
Isn't there anyone in the volunteer Admin here who has authority to edit??  Seems like ArduinoInc could trust a couple of common sense people.

I'd nominate you..  smiley-cool
Logged

Regards, Terry King terry@yourduino.com  - Check great prices, devices and Arduino-related boards at http://YourDuino.com
HOW-TO: http://ArduinoInfo.Info

Fort Lauderdale, FL
Offline Offline
Faraday Member
**
Karma: 71
Posts: 6144
Baldengineer
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

My vote for rights to change arduino.cc goes to everyone who has replied until this post.

Why not?  You guys, politely, correct the mistakes and answer the questions in the forum anyway...
Logged

Capacitor Expert By Day, Enginerd by night.  ||  Personal Blog: www.baldengineer.com  || Electronics Tutorials for Beginners:  www.addohms.c

nr Bundaberg, Australia
Offline Offline
Tesla Member
***
Karma: 129
Posts: 8602
Scattered showers my arse -- Noah, 2348BC.
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

Quote
I'd nominate you..
Gee thanks smiley
Actually I don't mind that sort of thing, I used to the the tech pubs for a company I worked for in a previous life.

Quote
Seems like ArduinoInc could trust a couple of common sense people.
Yes we've mentioned that before as well I seem to recall, and if we can't find anyone with common sense then maybe some of the regulars.

I would think that a few people should be given the rights to make small changes, maybe with a peer review. Same for all the docs, I'm sure this is going to get out of hand with the new boards.

I don't really know how the playground etc work, I suppose any changes there would have to be run past the original author.

______
Rob
Logged

Rob Gray aka the GRAYnomad www.robgray.com

Copenhagen, Denmark
Offline Offline
Edison Member
*
Karma: 33
Posts: 1226
Have you testrun your INO file today?
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Me thinks (oxymoron?) that because the tutorials form part of the distribution kit someone is worried about it has to change version number when edited.
Logged

Pages: [1]   Go Up
Jump to: