Com fer captures de pantalla útils per informar d’errors al Mac

Una captura d’una pantalla que no funciona deixa algunes preguntes obertes: quina acció l’ha provocat, què hauria d’haver passat i si passa cada vegada. Acompanya una captura centrada d’una explicació breu perquè qui investigui pugui reproduir el problema.

Aquest és un flux pràctic per informar d’un problema en una app del Mac o en un lloc web, amb una plantilla que pots copiar en un gestor d’incidències o en un missatge d’assistència.

1. Deixa prou context dins la imatge

Sempre que es pugui, captura alhora el control que falla i el resultat. Si un error apareix en prémer el botó Desa, inclou el botó, l’error i la part pertinent del formulari. Un escriptori sencer fa que els detalls petits siguin difícils de trobar; un missatge d’error aïllat pot amagar quina pantalla l’ha generat.

Fes servir dades d’exemple per reproduir el problema. Retalla les pestanyes i les dades del compte que no hi tinguin relació. El millor és eliminar les credencials i les dades privades abans de capturar; un desenfocament lleu no és una manera fiable d’amagar text.

La captura de regió de Floatie manté el resultat flotant mentre tornes a l’app i comproves els passos. Fes una captura separada si necessites un altre estat per explicar la seqüència.

2. Assenyala què has observat i després explica-ho

Sovint n’hi ha prou amb una fletxa cap al control que falla. Fes servir indicacions numerades quan el lector hagi de seguir un ordre i posa l’explicació al costat del fitxer adjunt. No dibuixis damunt de l’error exacte ni del valor que demostra el problema.

Amb una captura activa a Floatie, ⌘E obre l’editor Pro per afegir-hi fletxes, text i marques numerades. La pàgina de la funció d’edició presenta les eines.

Si l’error només existeix com a imatge, l’OCR pot ajudar-te a copiar-ne el text (en anglès). Comprova el resultat copiat amb l’original, sobretot la puntuació i els caràcters que s’assemblen. Inclou el text cercable de l’error a l’informe, a més de mostrar-lo a la imatge.

3. Afegeix aquesta plantilla per reproduir el problema

L’exemple és fictici; substitueix-lo per les teves observacions reals.

Títol: El botó Desa continua desactivat després d’introduir el nom del projecte

Entorn:
- App i versió:
- Versió de macOS:
- Navegador i versió, si escau:

Passos:
1. Obre un projecte nou.
2. Introdueix-hi un nom.
3. Prova de seleccionar Desa.

Resultat esperat: Desa s’activa després d’introduir un nom vàlid.
Resultat real: Desa continua desactivat.
Freqüència: S’ha reproduït en 3 de 3 intents.
Fitxer adjunt: desa-projecte-desactivat.png

Indica al camp de freqüència què has provat realment. Si només ha passat una vegada, digues-ho. Per a un problema de disseny d’un lloc web, inclou la mida de la finestra o el nivell de zoom si afecta el resultat.

4. Tria una captura o una gravació

Una captura serveix per mostrar un valor incorrecte, una etiqueta absent o un disseny trencat. Una gravació breu és més útil si desapareix un menú, es produeix un desplaçament inesperat o hi ha una seqüència de clics. Grava només la part pertinent de la pantalla (en anglès) i atura’t quan es vegi el comportament.

Adjunta el fitxer a la incidència si ha d’estar disponible juntament amb l’informe. Abans d’enviar-lo, obre’l i comprova que el text important sigui llegible. Si et limita la mida, redueix la mida de la captura sense perdre aquest detall.

Prova Floatie per al teu pròxim informe d’errors