Nuttige schermafbeeldingen maken voor een bugmelding op de Mac

Een schermafbeelding van een scherm met een probleem laat een paar vragen open: welke actie veroorzaakte het, wat had er moeten gebeuren en gebeurt het elke keer? Voeg een korte uitleg toe aan een gerichte opname, zodat degene die het probleem onderzoekt het kan reproduceren.

Dit is een praktische werkwijze om een probleem in een Mac-app of website te melden, met een template die je naar een issue tracker of supportbericht kunt kopiëren.

1. Laat genoeg context in beeld

Leg waar mogelijk zowel het probleem als het resultaat vast. Als de knop ‘Bewaar’ een fout veroorzaakt, neem dan de knop, de fout en het relevante deel van het formulier op. Op een volledig bureaublad zijn kleine details moeilijk te vinden; een losse foutmelding kan verhullen op welk scherm deze verscheen.

Gebruik voorbeeldgegevens om het probleem te reproduceren. Snijd niet-gerelateerde tabbladen en accountgegevens weg. Verwijder inloggegevens en privéwaarden liefst bij de bron voordat je een schermafbeelding maakt; een lichte vervaging is geen betrouwbare manier om tekst onleesbaar te maken.

Floaties regio-opname blijft zichtbaar terwijl je teruggaat naar de app om de stappen te controleren. Maak een aparte opname als je een andere toestand nodig hebt om de volgorde uit te leggen.

2. Markeer wat je hebt gezien en leg het daarna uit

Een pijl naar het onderdeel dat niet werkt is vaak genoeg. Gebruik genummerde markeringen als de lezer de volgorde moet volgen en zet de uitleg naast de bijlage. Teken niet over de exacte foutmelding of de waarde heen die de bug aantoont.

Druk met een actieve Floatie-opname op ⌘E om de Pro-editor voor pijlen, tekst en genummerde markeringen te openen. Op de pagina over de editorfunctie staan de gereedschappen.

Als de fout alleen als afbeelding bestaat, kan OCR helpen de tekst te kopiëren (in het Engels). Controleer de gekopieerde tekst aan de hand van het origineel, vooral leestekens en tekens die op elkaar lijken. Voeg de fouttekst ook als doorzoekbare tekst aan de melding toe.

3. Voeg deze template toe om het probleem te reproduceren

Het voorbeeld hieronder is fictief; vervang het door je eigen waarnemingen.

Titel: Bewaar blijft uitgeschakeld na invoer van een projectnaam

Omgeving:
- App en versie:
- macOS-versie:
- Browser en versie, indien relevant:

Stappen:
1. Open een nieuw project.
2. Voer een naam in.
3. Probeer Bewaar te selecteren.

Verwacht: Bewaar wordt beschikbaar nadat een geldige naam is ingevoerd.
Werkelijk: Bewaar blijft uitgeschakeld.
Frequentie: Reproduceerbaar in 3 van de 3 pogingen.
Bijlage: project-bewaar-uitgeschakeld.png

Vul bij frequentie in wat je echt hebt getest. Gebeurde het één keer, schrijf dat dan op. Vermeld bij een lay-outprobleem op een website de venstergrootte of zoominstelling als die het resultaat beïnvloedt.

4. Kies een schermafbeelding of opname

Een schermafbeelding werkt voor een verkeerde waarde, ontbrekend label of defecte lay-out. Een korte opname is nuttiger als een menu verdwijnt, de pagina onverwacht scrolt of er een reeks klikken nodig is. Neem alleen het relevante deel van het scherm op (in het Engels) en stop zodra het gedrag zichtbaar is.

Voeg het bestand aan de melding toe als het bij het rapport beschikbaar moet blijven. Open de bijlage voordat je deze verstuurt en controleer of de belangrijke tekst leesbaar is. Als een maximale bestandsgrootte in de weg zit, verklein dan de schermafbeelding met behoud van dat detail.

Probeer Floatie voor je volgende bugmelding