Differenze tra le versioni di "Bug/en"

Versione attuale delle 16:51, 24 mag 2022

Altre lingue:

In 1945 a moth caused a malfunction to the Marc II computer. Once removed, the Marc went back to working. This was the first ever computer bug, as recalled by lieutenant Grace Hopper.

How to report a bug of the AtlasFor platform.

What is a bug

A bug is an unintentional malfunctioning on an already existing function.

If you have an idea for a new function, that's not a bug, but you can submit it to the Landscapefor association. Thank you for your contribution!

How to report a bug

You are about to become an AtlasFor bug reporter. Follow these steps.

Step 1. Repeat

The best way to report a problem is describing the unusual situation that you found and help repeating that situation as quickly as possible again. Example:

❌ I saw a blank page today

✅ Today I clicked on this Facebook post that brought me here: https://atlas.landscapefor.eu/#test=toast. I usually see the map here, but I found a blank page instead. It happens both on desktop and mobile devices. It doesn't happen if I land here from other pages.

Step 2. Isolate

Did you know that AtlasFor has at least 40K lines of source code? Once you manage to repeat the bug, we need you help to isolate it:

try a completely different network (Wi-Fi / Mobile data)
try emptying the cache (click here: atlas:test-incognito.php)
try removing any Macro from the URL
try reducing the number of steps/click needed to repeat the issue
try another browser (Chrome or Chromium or Mozilla Firefox)
try after updating the browser (visit https://updatemybrowser.org/)
try at least another device (desktop VS mobile)
(only on desktop) click F12 and look for any red lines

These tests aim at helping another user to quickly repeat the bug. Quickly but accurately write down the results. For example:

❌ I opened AtlasFor, clicked on a POI, then on a title, then on the "Contacts" button on the side menu, ending up on "page not found"

❌ Atlas doesn't work on my iPhone 7

✅ Visiting https://atlas.landscapefor.eu/ from desktop and clicking on "Contacts" on the side menu I see "page not found". This happens with every desktop browser but non on mobile devices.

✅ Visiting https://atlas.landscapefor.eu/#test=toast on Safari on my iPhone 7 I see a blank page. This doesn't happen on any other browser or device. A friend of mine with the same phone has the same problem.

Step 3. Send the report

Forward your report to:

info at landscapefor.eu

Once sent your report will be copied here to help you track its progress:

List of AtlasFor reports

Step 4. Enrich

With various services like https://www.browserstack.com/ you can test your problem on many other devices for free, enriching your report.

You'll always be able to add some information to you report to shorten the fixing time.

Thanks again for your contribution!

@@ Riga 12: / Riga 12: @@
 You are about to become an AtlasFor ''bug reporter''. Follow these steps.
-=== Passo 1. Riproduzione ===
+=== Step 1. Repeat ===
-Il modo migliore per segnalare un problema è descrivere la situazione anomala che hai rilevato e aiutare a raggiungere quella situazione il più velocemente possibile altre volte. Esempio:
+The best way to report a problem is describing the unusual situation that you found and help repeating that situation as quickly as possible again.
+Example:
-: ❌ ''Oggi vedo una pagina bianca''
+: ❌ ''I saw a blank page today''
-: ✅ ''Oggi ho cliccato su questo post su Facebook che mi ha portato a questo indirizzo: https://atlas.landscapefor.eu/#test=toast. Di solito a questo punto vedevo la mappa ma invece ho una pagina bianca. Mi capita sia su desktop che su mobile. Non mi capita atterrando da altre pagine.''
+: ✅ ''Today I clicked on this Facebook post that brought me here: https://atlas.landscapefor.eu/#test=toast. I usually see the map here, but I found a blank page instead. It happens both on desktop and mobile devices. It doesn't happen if I land here from other pages.''
-=== Passo 2. Isolamento ===
+=== Step 2. Isolate ===
-Sapevi che AtlasFor ha almeno 40K righe di codice sorgente? Una volta che riesci a riprodurre il problema, serve il tuo aiuto per isolarlo:
+Did you know that AtlasFor has at least 40K lines of source code? Once you manage to repeat the bug, we need you help to isolate it:
-* test su rete completamente differente (Wi-Fi / dati)
+* try a completely different network (Wi-Fi / Mobile data)
-* test svuotando la cache (prova da qui: [[atlas:test-incognito.php]])
+* try emptying the cache (click here: [[atlas:test-incognito.php]])
-* test rimuovendo eventuali {{link|Macro}} dall'URL
+* try removing any {{link|Macro}} from the URL
-* test riducendo il numero di passaggi/click richiesti per riprodurre il problema
+* try reducing the number of steps/click needed to repeat the issue
-* test su altro browser (Chrome o Chromium o [https://www.mozilla.org/en-US/firefox/new/ Mozilla Firefox])
+* try another browser (Chrome or Chromium or [https://www.mozilla.org/en-US/firefox/new/ Mozilla Firefox])
-* test dopo aggiornamento del browser (visita https://updatemybrowser.org/)
+* try after updating the browser (visit https://updatemybrowser.org/)
-* test su almeno un altro dispositivo diverso (desktop VS mobile)
+* try at least another device (desktop VS mobile)
-* (solo su desktop) premi il tasto F12 e cerca eventuali righe in rosso
+* (only on desktop) click F12 and look for any red lines
-Questi test hanno l'obiettivo di aiutare un'altra persona a riprodurlo in poco tempo. Annota i risultati brevemente ma accuratamente. Esempi:
+These tests aim at helping another user to quickly repeat the bug. Quickly but accurately write down the results. For example:
-: ❌ ''Aprendo internet apro AtlasFor a questo punto se clicchi su un POI, poi clicchi su un titolo, poi clicchi sul menù laterale sulla voce "Contatti" mi dà "page not found"''
+: ❌ ''I opened AtlasFor, clicked on a POI, then on a title, then on the "Contacts" button on the side menu, ending up on "page not found"''
-: ❌ ''Dal mio iPhone 7 non funziona Atlas''
+: ❌ ''Atlas doesn't work on my iPhone 7''
-: ✅ ''Visitando https://atlas.landscapefor.eu/ da desktop e cliccando sul menù laterale sulla voce "Contatti" mi dà "page not found". Questo capita in qualsiasi browser su desktop ma non su mobile.''
+: ✅ ''Visiting https://atlas.landscapefor.eu/ from desktop and clicking on "Contacts" on the side menu I see "page not found". This happens with every desktop browser but non on mobile devices.''
-: ✅ ''Visitando https://atlas.landscapefor.eu/#test=toast su Safari nel mio iPhone 7 mi dà una pagina bianca. Non mi capita con nessun altro browser o con altri dispositivi. Inoltre un'amica con lo stesso telefono ha lo stesso problema.''
+: ✅ ''Visiting https://atlas.landscapefor.eu/#test=toast on Safari on my iPhone 7 I see a blank page. This doesn't happen on any other browser or device. A friend of mine with the same phone has the same problem.''
-=== Passo 3. Invio della segnalazione ===
+=== Step 3. Send the report ===
-Inoltra la tua segnalazione a:
+Forward your report to:
-* info chiocciola landscapefor.eu
+* info at landscapefor.eu
-Una volta inviata, la tua segnalazione sarà riportata qui per aiutarti a tracciare i progressi:
+Once sent your report will be copied here to help you track its progress:
-* [[gitpull:tag/atlasfor/|Elenco segnalazioni di AtasFor]]
+* [[gitpull:tag/atlasfor/|List of AtlasFor reports]]
-=== Passo 4. Arricchimento ===
+=== Step 4. Enrich ===
-Ci sono diversi servizi come https://www.browserstack.com/ che permettono di testare gratuitamente il tuo problema su molti altri dispositivi, permettendoti di arricchire la tua segnalazione.
+With various services like https://www.browserstack.com/ you can test your problem on many other devices for free, enriching your report.
-Ti sarà sempre possibile aggiungere qualche informazione alla tua segnalazione. Questo abbatterà i tempi di correzione.
+You'll always be able to add some information to you report to shorten the fixing time.
-Grazie ancora per il tuo contributo!
+Thanks again for your contribution!