4

Arduino, along with a couple of other subjects, are quite precise. I mean, all programming questions mostly consern the Arduino IDE and I find that the Arduino.cc's tutorial section rubish.

After looking at what Stack Overflow has in there documentation section, I would find it very convinient and great if we can import that into this site. It has many GREAT tutorials that could solve around 5% of the questions on this site (just a guess, no actual numbers).

And if we, as the Arduino comunity put a little more effort into it, we can turn it into the (maybe) greatest Arduino tutorial book / site out there. I see a lot of benefits for it. Mostly that We can share a lot of knowlage without having to ask a precise question.

So who's with me?

  • 2
    Beginners tend to not read documentation, but certainly I agree in principle that good documentation is very important. I'm not sure if the SO documentation project can be used here, but if it can it sounds like a good idea. – Nick Gammon Dec 21 '16 at 4:40
  • I would suggest that it could be a prominent part of the tour so people would know about it. Like the programming tag and Prettify and the Markdown Editor Help section. (And we should have a LaTex tag if that's what it takes to be able to copy answers from EE SE to here without the need to reformat our math into FORTRAN 77 – SDsolar Jun 1 '17 at 15:45
  • We can make an answering bot: it automatically google the question and offers the first search result from this site as answer. – user31481 Aug 8 '17 at 10:38
4

I'm not sure documentation per se is going to be useful. As Nick has noted reading documentation is something that many of our incoming users ("Ardueenies") are averse to doing.

Another thing they seem averse to doing is searching. The number of duplicate questions we get seems to be rather high. So instead of spending our time on documentation, it may be better to put our efforts into crafting "FAQ" questions where we cover, in detail, a specific topic. Then when we get a question that asks what that FAQ question covers we just close it as a duplicate pointing to the FAQ question.

This has proved successful on EE, especially for the question "What power supply do I want" or "Will my power supply blow up my project because of too many amps" and similar that seem to get asked about every 15 minutes. They all get almost immediately closed as a duplicate of "Choosing power supply, how to get the voltage and current ratings?"

Questions that people ask all the time that could be covered by this kind of thing (please suggest more):

  • I have added a shield that has pins in all the Arduino's holes. Can I still use some of them?
  • Can I run my Arduino of XXX power supply?
  • Can I use an external power supply for my Arduino and still plug it into the USB? Will it blow up?
  • How do you merge two k0d3z together? Will do you it for me? plz?
  • How do I communicate between my Arduino and my PC / a Website / Neptune?
  • What is the extra 6 pin header for on the Uno R3?

The list could go on for miles I am sure. Building up a store of these good quality in-depth answers would not only make life easier on us, since we would have to write less answers in the long run, but also would help the people asking the questions as they then get handed a well crafted, well thought out, detailed answer to their question instead of a half-arsed answer that we can't be bothered to flesh out because the same question has been asked time and time again and if only they'd spend the time doing a little searching, reading, and thinking about what they have found they would come up with the answer themselves.

  • How to communicate with GPS and GSM at the same time: is a popular one too. – Dat Ha Dec 24 '16 at 17:34
  • Yes, I saw that one arrive just now ;) – Majenko Dec 24 '16 at 17:35
  • I agree, @Majenko. FAQ comes to mind. I am amazed how many times I post a question on Google only to be directed to a 3-year-old answer posted in EE SE or here. Maybe in the tour it could be made clear that we are not a free software-production service. Even better, perhaps automate the "Welcome ... take the tour" thing also. That way it doesn't look like any particular one of us is trying to act like a gatekeeper. (Mea culpa) – SDsolar Jun 1 '17 at 15:51

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .