Hoe u een fout in Gaphor kunt melden

Als u ooit een regel code heeft geschreven, zal u weten dat alle software fouten bevat. Dit zal ook het geval zijn met Gaphor. Als u denkt een fout te hebben gevonden, klik dan op onderstaande link (u moet een account hebben op GitHub) en klik dan op de groene knop ‘New Issue’ rechtsboven op de pagina:

Meld een fout in Gaphor

Wanneer u een nieuwe issue aanmaakt, krijgt deze een nummer en worden de vrijwillige ontwikkelaars, die de code schrijven en onderhouden, per e-mail op de hoogte gebracht. Zij kunnen vragen toevoegen aan uw probleem, als deze niet duidelijk is. Ze kunnen het onmiddellijk sluiten en markeren als ‘duplicaat’ (iemand anders heeft de fout al gemeld, en ze verwijzen naar het oorspronkelijke probleem). Soms zullen ze de issue sluiten en zeggen ‘wordt niet opgelost’, omdat ze het er niet mee eens zijn dat het een fout is of te triviaal is om tijd in te steken.

Over het algemeen zijn er twee soorten fouten:

  • Technisch: in de code zit een fout waardoor de app incorrect werkt of crasht.
  • Gedragsmatig: de code werkt correct, maar doet iets anders dan verwacht.

In beide gevallen hebben we zoveel mogelijk informatie nodig om de fout te kunnen oplossen. Wanneer u een nieuwe issue aanmaakt moet u proberen om, indien relevant, de volgende informatie toe te voegen:

  • wat u probeerde te doen,
  • welke stappen u hiervoor heeft ondernomen,
  • Wat u verwachtte dat er zou gebeuren,
  • wat er in werkelijkheid gebeurde,
  • waarom dit verschil problematisch is, (mogelijk is het geen fout!)
  • Technische details zoals de versie van Gaphor die u gebruikt, uw besturingssysteem inclusief versie, en andere aspecten van de context waarin Gaphor werd uitgevoerd.

Gebruik duidelijke en eenvoudige taal om het probleem te beschrijven en, indien nuttig, verdeel het in stappen zodat ontwikkelaars het probleem gemakkelijk kunnen reconstrueren. Ga er niet van uit dat wij begrijpen wat u probeerde te bereiken; eerlijk gezegd is het het beste als u zich voorstelt dat wij (de ontwikkelaars) een stel slimme 5-jarigen zijn. Probeer alles uit te leggen over het probleem en ga er niet van uit dat we weten wat u bedoelt. We zullen het niet erg vinden!

Als u meer betrokken wilt raken bij de ontwikkeling van Gaphor, verwelkomen wij u graag via de ontwikkelaarswebsite van Gaphor.