[Leggere prima di scrivere] Come chiedere aiuto, aiutateci ad aiutarvi

Con l'introduzione del nuovo regolamento del forum la seguente raccolta di regole diventa solo di approfondimento al primo.

In questi giorni vedo che si moltiplicano sul forum italiano tante richieste di persone che probabilmente sono alle prime armi e che esordiscono con domande del tipo:" il coso che ho costruito non funziona, come mai?", sperando nella presenza nel forum di qualche utente dotato di capacità paranormali in grado di vedere a distanza il montaggio e capire quale arduino usate, leggere nel pensiero il codice , ricordare a memoria i datasheet di componenti sconosciuti :smiley:

Per gli utenti con più esperienza che hanno voglia e tempo di rispondere, può essere frustrante dover fare prima domande per capire di cosa si tratta, per cui aiutateci ad aiutarvi! infondo non è difficile basta fornire in fase di richiesta, la maggior quantità di dettagli disponibili, anche quelli che a voi sembrano insignificanti.
Quindi prima di iniziare, se volete farlo con il piede giusto dovreste ricordare che:

1 ) se sei nuovo, non chiedere aiuto nel tuo 1° post. E' educazione presentarsi, prima smiley-razz

2 ) prima di chiedere aiuto usa gli strumenti a tua disposizione per cercare di risolvere il tuo problema:
a ) funzione "search" del forum: il forum di Arduino è frequentato da una moltitudine di persone e quasi certamente qualcun altro ha già avuto un problema simile al tuo
b) "San Google": internet è ancor più vasto, una ricerca su Google al 90% risolve il tuo problema
c) c'è il Playground del sito: contiene un sacco di progetti già pronti e spiegati, magari proprio quello basato sul componente che ti sta dando problemi
d) il Reference spiega tutte le funzioni ed i comandi del linguaggio usato da Arduino, se il tuo problema è la sintassi consulta prima il Reference

3 ) NON mettere nel titolo del thread frasi monovocaboli tipo "Aiuto!", "Non funziona", "Bruciato tutto", "Prime armi" ma descrivere sommariamente il problema:
"Problema nell'uso dei led"
"Problema nell'uso di una memoria EEPROM"
"Problema con la seriale"

4 ) NON SCRIVERE TUTTO MAIUSCOLO!!!!
Questo equivale AD URLARE!!! Ed è una cosa molto da maleducati. Vale sia nei titoli delle discussioni che all'interno delle stesse.

5 ) per aiutare chi vi vuole aiutare descrivere:
a ) l'hardware utilizzato nel dettaglio: il tipo di Arduino, i componenti usati
b ) il sistema operativo usato: spesso le cose cambiano da SO a SO, inoltre già si può ricevere aiuto da chi ha lo stesso SO
c ) nel caso di un programma che non funziona, includere sempre lo sketch con i tag specifici (l'icona "#")
d ) nel caso di collegamenti elettrici, riportare sempre lo schema preferibilmente disegnato con Eagle o Kicad, evitare schizzi a mano o Fritzing (va bene per i blog, non va bene per chiedere aiuto)
e ) descrivere bene cos'è che non va e cosa dovrebbe invece accadere. Dire "la seriale non funziona" non significa nulla, bisogna dire cosa si sta facenda con la seriale (spedire un carattere, aspettare un input), cosa succede e cosa invece dovrebbe succedere

6 ) non pretendere risposte immediate o la risoluzione di tutti i problemi, il forum è una comunità di utenti che mettono a disposizione dello stesso una parte del loro tempo libero, non è un centro assistenza dove si ha diritto ad una risposta risolutiva perché si è pagato un servizio smiley-wink

7 ) evitare di fare l'up della discussione se non si ottiene risposta per riportarla in cima a quelle da leggere.
smiley-cool
una volta risolto il problema, è cosa gradita porre il testo [Risolto] nel titolo del thread per evitare che utenti distratti continuino a rispondere alla discussione. Per fare ciò basta che l'autore del thread clicchi su "Modify" del 1° post e cambi il titolo, e successivamente salvi la modifica.

8 ) “Non siamo l’ufficio informazioni per il vostro progetto”

9 ) "Va bene essere ignoranti ma non va bene fare gli stupidi”

10 ) Prima di fare una domanda tecnica fai le cose che seguono:
Cerca di trovare una risposta cercando nel web
Cerca di trovare una risposta leggendo il manuale
Cerca di trovare una risposta consultando la FAQ (sezione del sito = domande frequenti)
Cerca di trovare una risposta ispezionando, ricontrollando e sperimentando.
Cerca di trovare una risposta chiedendo ad un amico esperto
Se sei un programmatore, cerca di trovare la risposta ricontrollando e leggendo il tuo codice sorgente.

Per esempio se state armeggiando con il blink di un led e non funziona sarebbe bello sapere almeno:
Quale arduino usi?
Come lo alimenti?
Che led usi? (se possibile, link al datasheet)
Che codice usi?
Con quale versione IDE?
Hai una foto del montaggio?

Se chi chiederà aiuto quì porrà le domande tenendo presente questi criterii, vedrete che i vostri problemi avranno vita breve :slight_smile: