Bugs
How to report a bug of the AtlasFor platform.
Indice
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. Isolation
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:
- do a test on a completely different network (Wi-Fi / Mobile data)
- test svuotando la cache (prova da qui: atlas:test-incognito.php)
- test rimuovendo eventuali Macro dall'URL
- test riducendo il numero di passaggi/click richiesti per riprodurre il problema
- test su altro browser (Chrome o Chromium o Mozilla Firefox)
- test dopo aggiornamento del browser (visita https://updatemybrowser.org/)
- test su almeno un altro dispositivo diverso (desktop VS mobile)
- (solo su desktop) premi il tasto F12 e cerca eventuali righe in rosso
Questi test hanno l'obiettivo di aiutare un'altra persona a riprodurlo in poco tempo. Annota i risultati brevemente ma accuratamente. Esempi:
- ❌ 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"
- ❌ Dal mio iPhone 7 non funziona Atlas
- ✅ 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.
- ✅ 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.
Passo 3. Invio della segnalazione
Inoltra la tua segnalazione a:
- info chiocciola landscapefor.eu
Una volta inviata, la tua segnalazione sarà riportata qui per aiutarti a tracciare i progressi:
Passo 4. Arricchimento
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.
Ti sarà sempre possibile aggiungere qualche informazione alla tua segnalazione. Questo abbatterà i tempi di correzione.
Grazie ancora per il tuo contributo!
