Pages: [1]   Go Down
Author Topic: [REGOLAMENTO] Come usare questo forum - leggere per favore  (Read 5829 times)
0 Members and 1 Guest are viewing this topic.
Global Moderator
Offline Offline
Brattain Member
*****
Karma: 452
Posts: 18694
View Profile
 Bigger Bigger  Smaller Smaller  Reset Reset

Prima di usare questo forum ed ottenere il massimo da esso, per favore leggi questa guida. Grazie!

- Il Team del Forum di Arduino



1. Registrazione e accesso
Create un account (se necessario), ed effettuate il login (accesso):





2. Scegliete la sezione del forum più appropriata
Potete pubblicare la vostra domanda nell'area principale del forum: scegliete la sezione più appropriata fra quelle disponibili (sono state evidenziate alcune di esse):





3. Scegliete una sezione con una lingua differente
Nelle sezioni dell'area principale del forum si utilizza la lingua Inglese. Se volete pubblicare una domanda in Italiano dovete scegliere la sezione "Italiano":





4. Effettuate una ricerca prima di pubblicare la domanda
Cercate di rispondere alla vostra domanda per proprio conto, vale a dire provate a risolvere il vostro problema da soli. Ad esempio, se vi state chiedendo come collegare dei LED ad un 74HC595, cercate con Google esattamente questo (aggiungete la parola "Arduino" per ottimizzare la ricerca):



L'esempio fatto ha dato un sacco di risultati. Leggetene qualcuno, magari la vostra domanda ha già avuto una risposta. Se non lo fate, e la vostra domanda indica che non avete provato a risolvere da soli il vostro problema, potreste trovare qualcuno che vi risponde così:





5. Pubblicare un nuovo quesito
Prima di pubblicare la vostra domanda, scegliete la giusta area tematica:



In "Hardware" vanno pubblicate le domande riguardanti l'interfacciamento di componenti elettronici quali sensori, schede e dispositivi vari con Arduino; in "Software" vanno pubblicate le domande riguardanti la programmazione delle schede Arduino; in "Megatopic" si pubblicano i progetti che si intende condividere con la comunità, completi di codice e schemi elettrici; in "Generale" tutto ciò che non rientra nelle precedenti categorie.

Scelta l'area tematica corretta, per inserire una nuova domanda cliccate su "New topic":





6. Inserire un oggetto appropriato
Cercate di sintetizzare la vostra domanda in un oggetto appropriato e che dia l'idea del problema. Un oggetto scritto correttamente aiuta a richiamare l'attenzione degli utenti che possono conoscere la risposta al vostro problema. Oggetti scritti male o non descrittivi del problema possono indurre gli altri utenti a saltare la lettura della domanda.

Esempi di oggetti che non sono descrittivi o inutili:

  • Sono nuovo, cerco aiuto
  • Cerco aiuto in fretta
  • Non funziona nulla
  • Errori
  • Ho un problema con un sensore/circuito/componente
  • Aiuto!
  • SCRIVO TUTTO IN MAIUSCOLO COSI' SI LEGGE MEGLIO

Soprattutto evitate di scrivere gli oggetti usando le LETTERE MAIUSCOLE. Sono sconvenienti da usare e non piacciono ad un sacco di persone perché il maiuscolo significa che si sta urlando.

Quello che segue è invece un esempio di un oggetto scritto correttamente:






7. Se pubblicate del codice o dei messaggi di errore, usate il tag "code"
Quando pubblicate del codice, dei messaggi di errore, l'output di un programma, selezionate il codice e poi cliccate sul pulsante "Insert code" come mostrato qui sotto:



In questo modo rendete il codice molto più leggibile, evidenziandolo dal resto del testo, come nell'esempio seguente:
Code:
a = b [i];

Inoltre evitate che qualche sequenza di caratteri particolari possa alterare il modo in cui viene visualizzato il resto del vostro messaggio.
Dopo che avete cliccato sul pulsante "Insert code", il vostro codice ed i vostri messaggi appariranno così:



Nell'esempio qui sopra, dopo la selezione del codice è stato premuto il pulsante "#", e così è stato fatto anche per il messaggio di errore.

Cliccando sul pulsante "Preview", posto sotto all'area in cui state inserendo il testo della vostra domanda, potete vedere come i tag code hanno operato, e controllare che tutto sia a posto prima della pubblicazione:





8. Aggiungere allegati
Se il vostro codice è troppo lungo per essere inserito all'interno di un messaggio, o se avete diversi file da inserire (ad esempio il codice e delle librerie), oppure se volete mostrare un'immagine di uno schema o una foto, cliccate sul pulsante "Additional Options":



Dal pannello che si apre potrete cercare sul vostro sistema la foto, il file di codice, lo schema o l'immagine che volete allegare al messaggio.



Per favore, ridimensionate le foto e le immagini affinché siano di una grandezza ragionevole: una foto da 4 MB richiede un bel pò di tempo per essere caricata. Come segno di cortesia verso gli altri utenti del forum, cercate di allegare immagini che non siano più grandi di qualche centinaio di kB e/o con una risoluzione non troppo elevata.


9. Inserire delle immagini
Se avete delle immagini ospitate su un vostro sito (o su un sito pubblico), potete inserirle direttamente all'interno del messaggio. Cliccate sul pulsante "Insert image":



Poi inserite l'URL dell'immagine all'interno dei tag "img":





10. Pubblicare domande corrette
Questo è un forum che state usando, non è un telefonino.

Come cortesia nei confronti delle persone che stanno cercando di aiutarvi siete pregati di scrivere frasi complete e grammaticalmente corrette. Vale a dire:

  • iniziate una frase con la lettera maiuscola;
  • scrivete le parole correttamente;
  • terminate la frase con un punto. (come questo, grazie!)

Ad esempio, al posto di un messaggio come questo:

Quote
ho bisogno del vs aiuto con il mio codice non so cosa non va per favore aiutatemi sono nuovo grz

scrivete qualcosa come questo:
Quote
Salve. Ho bisogno del vostro aiuto per correggere il mio codice, che allego qui di seguito.

Code:
codice inserito nei tag code

Ottengo i seguenti messaggi di errore:

Code:
errori inseriti nei tag code

Grazie per il vostro aiuto.

Scrivere un messaggio in modo corretto e con la giusta punteggiatura è una forma di cortesia e di rispetto, cose che potranno aumentare le possibilità di ricevere un aiuto.



L'originale di questo documento è reperibile qui.
« Last Edit: April 09, 2013, 02:20:41 am by leo72 » Logged

Global Moderator
Italy
Offline Offline
Brattain Member
*****
Karma: 313
Posts: 21645
Logic is my way
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

11. Suggerimenti per ottenere il massimo aiuto dalla vostra richiesta

  • Specificate che modello di Arduino avete: UNO? Leonardo? DUE? Mini? MEGA2560? Il problema potrebbe essere specifico di una determinata scheda.
  • Descrivete dettagliatamente il problema
  • Se è correlato ad un particolare componente elettronico (integrato o scheda), inserite anche l'esatto codice del componente e, se possibile, un collegamento ad un datasheet.
  • Descrivete come avete collegato i componenti quali gli interruttori: sono connessi a massa? Oppure ai +5 V? Ci sono delle resistenze di pull-up o di pull-down? Se potete, pubblicate lo schema del circuito o una foto di esso.
  • Fornite uno sketch completo (il codice del programma)! Almeno non perdete tempo a causa delle persone che poi vi chiedono di farlo. Inoltre, per problemi di codice, se possibile pubblicate uno sketch "minimale" che replica il problema - non centinaia di righe di codice. Se il problema sparisce nello sketch minimale, l'errore non era dove pensavate fosse.
  • Copiate ed in incollate il codice. Non riscrivetelo "a memoria" usando il vostro telefonino mentre siete in treno.
  • Se ottenete un errore, pubblicatelo (copia-e-incolla). Non scrivete semplicemente "mi dà errore".
  • Se fate generare delle informazioni di debug dal vostro sketch, pubblicate anche i messaggi di debug.
  • Se state usando una libreria che non è inclusa nell'IDE (se, cioè, l'avete scaricata da qualche parte) per favore fornite il link per recuperarla.
  • Descrivete cosa vi aspettavate succedesse e cosa invece accade. Non scrivete semplicemente "non funziona".
  • Se possibile, descrivete cosa state realmente cercando di fare, non cosa pensate potrebbe funzionare. Ad esempio: "Sto cercando di accendere contemporaneamente un riscaldatore ed una pompa di un acquario", non "Come posso sollevare un interrupt?".
  • Cercate di circoscrivere il problema, sia nel codice che nell'elettronica. Non confondete né voi stessi né chi vi sta aiutando cercando di fare tutto nello stesso momento. Ad esempio, se state avendo dei problemi con la lettura di un sensore, fate un piccolo test con il quale leggere solo il sensore (sia elettronicamente che con il vostro programma).



12. Non inviate richieste tecniche alle persone mediante "messaggio"
La funzione di messaggistica del forum è per l'invio di messaggio personali, non per richieste tecniche.



Non è corretto individuare qualcuno che pensate potrebbe darvi un aiuto e cercare di ottenere una sorta di assistenza personale. Se fate così, vi suggerisco di prepararvi a pagare per questa forma di aiuto ad personam.

Se volete a tutti i costi attirare l'attenzione di chi appare ai vostri occhi come l'esperto che può risolvere il vostro problema, provate prima a pubblicare la vostra richiesta sul forum (come descritto qui sopra). Attendete poi un paio di giorni: quella persona potrebbe essere impegnata. Se poi quella persona non vi ha risposto, e nessun altro è stato in grado di aiutarvi, provate ad inviargli un breve messaggio con il quale richiedete la sua assistenza, includendo l'URL (link) della discussione.
Se non inserite il link alla discussione, la persona a cui state richiedendo l'aiuto deve anche mettersi a cercare dove essa sia, ed il tempo che perde potrebbe rallentare, se non bloccare, la sua risposta.

Fate caso che generalmente ogni domanda pubblicata sul forum ottiene una risposta di qualcuno nel giro di qualche ora. Chiedere l'aiuto di una persona in particolare potrebbe portare invece ad un tempo di attesa più lungo, perché essa potrebbe essere a dormire, al lavoro, a pescare o a fare qualsiasi altra cosa.



13. Etichetta del forum
La prima regola da rispettare è l'educazione. Quando si arriva in un posto nuovo è sempre gradito presentarsi: nella sezione italiana esiste un thread apposito per le presentazioni. Dopo la presentazione, il consiglio è quello di leggere il forum per qualche giorno in modo da capire come vengono trattati i vari argomenti. Una volta fatto questo, pubblicate la vostra domanda seguendo le linee guida esposte più sopra e rispettando la netiquette.

Ora che avete pubblicato la vostra domanda, ci sono alcune regole da tenere a mente:


Non fate cross-posting!
Lo sappiamo che siete impazienti di ottenere la risposta al vostro problema, ma ri-pubblicare la stessa domanda in più sezioni del forum duplica gli sforzi e riduce l'attenzione al vostro problema. Ottenete senz'altro una miglior risposta se tutti possono discutere il problema in un unico posto. Il cross-posting è veramente fastidioso: i moderatori cancelleranno i messaggi extra e voi riceverete un richiamo. Perciò evitate i battibecchi e pubblicate una sola richiesta d'aiuto. Sarà apprezzato.

Se non siete sicuri in quale sezione pubblicare la richiesta (Hardware, Software, Generale ecc...) fate un tentativo. Ma non fate un cross-post "giusto per fare".

Non fate up!
Non fate un "up" della vostra discussione dopo appena un'ora. Ci sono persone che potrebbero essere in parti del mondo con diversi orari, che potrebbero dormire, oppure lontani dal computer. Aspettate almeno un paio di giorni.

Se la vostra domanda non ha ottenuto neanche una risposta, rileggetela per bene per vedere se avete fornito abbastanza informazioni affinché le persone possano aiutarvi. Alla fine... avete fatto una domanda?

Le persone stanno cercando di aiutarvi
Se qualcuno vi risponde chiedendovi maggiori dettagli, probabilmente sta cercando di capire cosa state cercando di fare. Non confondetelo con risposte del tipo "non è importante": più dettagli del vostro progetto fornite, maggior aiuto potete ottenere.

Usate una firma breve
Una firma dovrebbe possibilmente essere composta da una sola riga di testo, e pertinente: una firma che linka ad un sito senza legami con questo forum (come un sito dedicato ad una competizione sportiva) può essere considerata una forma di spam e portare quindi al ban.

Siate educati
Un pò di cortesia e di educazione portano molto lontani. Anche se pensi che una domanda simile sia già stata fatta in precedenza oppure se non capisci il motivo della richiesta, rispondi con gentilezza.
Ricorda che gli utenti con molti messaggi all'attivo magari vedono le stesse domande tutti i giorni, e potrebbero apparire un pò concisi se essi pensano che non vi siete impegnati a fondo per cercare di risolvere prima da soli il problema.
Vi accorgerete che se risponderete in maniera amichevole, gli altri vi ripagheranno di ciò e con molta probabilità risolverete i vostri problemi.

Questo forum non è Ebay
Non usate il forum per pubblicizzare e/o commercializzare servizi e/o oggetti prodotti da voi o per conto terzi, offerti direttamente (qui sul forum) o indirettamente (link a siti esterni). Si possono segnalare prodotti offerti da siti di e-commerce se tali prodotti sono inerenti la discussione o indicativi della categoria del prodotto di cui si sta parlando.

Interventi di moderazione
Il funzionamento del forum è subordinato al buon comportamento degli utenti ed al loro rispetto delle regole. Sul forum esercita la supervisione un gruppo di utenti dedito all'amministrazione, gli admin ed i moderatori. Un moderatore può, a suo insindacabile giudizio, moderare (modificare, spostare, cancellare in parte o del tutto) un messaggio od una discussione se ritiene che non non sia conforme al regolamento e/o al comune senso civico. Infrangere le regole può portare ad un richiamo da parte di un moderatore, sia in forma privata che pubblica. Eventuali contestazioni sull'operato di un moderatore devono essere condotte in forma privata ma sempre nel rispetto del suo ruolo e con toni civili. Contestare in maniera irriguardosa e/o ingiustificata l'operato di un moderatore oppure reiterare nell'azione che ha portato al richiamo può comportare il ban.

« Last Edit: January 06, 2014, 06:17:28 am by leo72 » Logged


Global Moderator
Italy
Offline Offline
Brattain Member
*****
Karma: 313
Posts: 21645
Logic is my way
View Profile
WWW
 Bigger Bigger  Smaller Smaller  Reset Reset

14. Una volta che avrete ottenuto una risposta...
Riceverete senz'altro in breve tempo diversi suggerimenti utili. Leggeteli bene.

  • Se in una risposta viene menzionato qualcosa che non capite (ad esempio, uno "shift register") cercate prima di trovare da soli cosa significa, ad esempio usando Google.
  • Se non capite una parte della risposta, ditelo. Dite quale parte. Non ignorate semplicemente la cosa.
  • Applicate i suggerimenti proposti, anche se non sembrano rilevanti per voi. Anche piccoli cambiamenti apparentemente insignificanti possono risolvere il vostro problema.
  • Cercate di capire cosa viene richiesto. Ad esempio: "che codice?" significa: "Per favore pubblica il codice".
  • Se apportate dei cambiamenti e le cose continuano a non funzionare, pubblicate il codice (o i collegamenti) modificato in modo appropriato (in un nuovo messaggio).
  • Rispondete alle domande. E' frustrante stare 3 pagine a cercare di farsi dare il codice che l'utente sta usando, oppure i collegamenti che ha realizzato.
  • A parte l'aggiunta dei tag code, per favore non modificate il codice nei precedenti messaggi per fare delle correzioni. Questa cosa rende i messaggi seguenti strani. Pubblicate invece il codice modificato in un nuovo messaggio.
  • Una volta che avete risolto il vostro problema, non cancellate la discussione! Si suppone che il forum sia una fonte di conoscenza: cancellare un forum una volta che siete soddisfatti delle risposte non aiuta le persone che in un futuro potrebbero cercare risposta ad un problema simile.
  • Allo stesso modo, se avete risolto il vostro problema, come segno di cortesia per le persone che leggeranno la discussione in seguito, spiegate cosa avete modificato per arrivare alla soluzione (ad esempio, pubblicato il circuito corretto oppure il codice funzionante).
  • Se considerate il problema risolto, per favore editate il messaggio originale (il primo della discussione) ed aggiungete "[Risolto]" nell'oggetto. Ciò aiuta gli altri utenti a capire che il problema è stato risolto e ad evitare di continuare a fornire assistenza nonché mette in evidenza, durante una ricerca, che il problema citato nel titolo ha avuto una soluzione. Grazie!


La versione originale di questa guida è reperibile qui.
Logged


Pages: [1]   Go Up
Jump to: