Come chiedere aiuto

Ultimo aggiornamento: 15/45/2024 alle 14:45:14

Indice
  1. Fai le tue ricerche
  2. Apri un post
  3. Descrivi il problema prima di copia-incollare l’errore o il codice
  4. Aiuta gli altri a riprodurre il problema
  5. Rileggete il messaggio dopo averlo scritto
  6. Rispondere ai feedback
  7. Descrivete brevemente la soluzione

Fare una domanda è facile. Il vero problema consiste nel porla in modo corretto per avere la miglior risposta nel minor tempo possibile. Ecco alcuni consigli presi da stackoverflow.

Fai le tue ricerche

Prima di aprire un nuovo post sul moodle, chiedere ai tuoi colleghi o mandare una mail a noi, cerca (sia su un motore di ricerca che qui sul forum) se qualcuno ha avuto lo stesso problema. Le difficoltà che si hanno all’inizio sono abbastanza comuni ed è facile che qualcuno abbia avuto il vostro stesso problema. Se non trovate in italiano provate in inglese (anche a costo di tradurre con chatgpt). Il mondo dell’informatica, come quello della ricerca scientifica, parla inglese. Se qualcuno ha avuto il vostro stesso problema ma non ha ancora trovato la risposta fategli sapere che avete lo stesso problema rispondendo alla sua domanda aggiungendo i vostri dettagli. https://chatgpt.com/

Apri un post

Iniziamo dalla prima cosa che viene visualizzata, il titolo. Questo deve essere allo stesso tempo conciso e il più descrittivo possibile. Troppo lungo e nessuno avrà il tempo di leggerlo, troppo corto e nessuno capirà se è in grado di aiutarvi. Cercate di trovare un equilibrio fra i due casi. Come per i titoli degli articoli scientifici spesso conviene scrivere il titolo all’ultimo.

Esempi:

  • 👹 Brutto titolo: La macchina virtuale non funziona.

  • 😎 Ottimo titolo: Errore unsupported architecture durante l’esecuzione della virtual machine su Mac con chip M1.

  • 👹 Brutto titolo: mkdir non funziona
  • 😊 Buon titolo: mkdir crea due cartelle invece che una.

  • 😎 Ottimo titolo: Come posso creare una cartella con uno spazio vuoto nel nome?

  • 👹 Brutto titolo: Non capisco niente
  • 😕 Titolo discreto: gli algoritmi sono troppo difficili.
  • 😎 Ottimo titolo: Quali sono le differenze fra un algoritmo e una dimostrazione matematica?
  • 😎 Ottimo titolo: Richiesta risorse addizionali sugli algoritmi.

Descrivi il problema prima di copia-incollare l’errore o il codice

Prima di copia-incollare l’errore, è utile introdurre cosa volete fare e come avete provato a farlo. Questa introduzione aiuta a concentrarsi sul problema che volete risolvere e non sulla vostra soluzione. Magari esiste un modo più efficace di quello che avete pensato voi o avete dimenticato un passaggio necessario prima di quello che vi fornisce un errore. Dopo aver spiegato la vostra situazione, inserite tranquillamente l’errore che avete trovato.

Aiuta gli altri a riprodurre il problema

Difficilmente la persona che vuole aiutarvi ha già incontrato lo stesso esatto problema. Molto spesso ha incontrato un problema simile e ha una mezza idea di come risolvere questo caso. Prima di rispondere alla vostra domanda, vorrà probabilmente prendere il suo computer e cercare di ottenere lo stesso errore per poi provare a risolverlo. Aiutatelo in questi passaggi. Inserire nel corpo del vostro post come siete arrivate all’errore, quali comandi avete inserito o quali linee di codice avete scritto. Più informazioni date più facile sarà aiutarvi. Se avete provato a risolvere il problema in qualche modo o avete trovato qualche risorsa online che vi sembra pertinente allegate il link.

In ogni caso, non allegate il codice sottoforma di immagini. Il tempo è la risorsa più preziosa che abbiamo. Nessuno si prenderà la briga di copiare tutto il vostro codice a mano nel suo computer. Piuttosto allegate il codice o l’errore come testo nel messaggio o, se particolarmente lungo, tramite siti di hosting quali https://gist.github.com/. Le immagini vanno bene per i grafici e le informazioni che non possono essere comunicate in altro modo.

Rileggete il messaggio dopo averlo scritto

Controllate la coerenza logica del vostro post prima di inviarlo. Questo passaggio non serve solo a controllare la coerenza di quello che avete scritto ma anche ad avere una visione più oggettiva del problema. Spesso la soluzione corretta viene in mente proprio durante una rilettura. Questo è anche un ottimo punto per controllare se il titolo è descrittivo del problema.

Ora che avete scritto e revisionato il post pubblicatelo e andate a fare una pausa. Prendete un caffè, fate una camminata (avete fatto i vostri giri di Povo 1 giornalieri?) e rilassatevi un po’. Dopo una mezzoretta ricontrollate il post. Se qualcuno ha risposto è il momento di…

Rispondere ai feedback

Qualcuno ha deciso di utilizzare il suo tempo per aiutarvi. Perfetto! Leggete la sua risposta e cercate di aggiugere i dettagli che avete dimenticato o provate le soluzioni proposte. Qualsiasi cosa succeda ricordate di:

  1. Non prendere le risposte sul personale. In questo momento siete un team che sta cercando di risolvere un problema, non due duellanti che cercano di aver ragione.
  2. Cercate di fornire più dettagli possibili alla luce delle soluzioni che vi sono state proposte. Se ne avete la possibilità, incontratevi di persona e prendete appunti.

Descrivete brevemente la soluzione

Una volta che avete trovato una soluzione scrivete un riassunto dei passaggi che vi hanno permesso di raggiungerla. Non penso sia possibile sottolineare abbastanza questa cosa. Risolvere problemi tecnici è uno sforzo collettivo che richiede tempo ed energie da parte di tutti. Cercate di semplificare il più possibile la vita a chi avrà un problema simile dopo di voi.

Altre Risorse: