Como fazer capturas de tela úteis para relatar bugs no Mac

Uma captura de uma tela com problemas deixa algumas perguntas em aberto: qual ação causou aquilo, o que deveria ter acontecido e se ocorre todas as vezes. Combine uma captura objetiva com uma explicação curta para que a pessoa que investigar consiga reproduzir o problema.

Este é um fluxo prático para relatar um problema em um app para Mac ou em um site, com um modelo que você pode copiar para um rastreador de bugs ou mensagem de suporte.

1. Inclua contexto suficiente na imagem

Quando possível, capture o controle com problema e o resultado juntos. Se o botão Salvar gerar um erro, inclua o botão, o erro e a parte relevante do formulário. A mesa inteira dificulta encontrar detalhes pequenos; uma mensagem de erro isolada pode esconder qual tela a produziu.

Use dados de exemplo para reproduzir o problema. Corte abas sem relação com o caso e informações da conta. É melhor remover credenciais e dados privados na origem antes de capturar; um desfoque leve não é uma forma confiável de ocultar texto.

A captura de região do Floatie deixa o resultado flutuando enquanto você volta ao app e confere as etapas. Faça outra captura se um estado diferente for necessário para explicar a sequência.

2. Marque o que observou e depois explique

Uma seta para o controle com problema costuma bastar. Use chamadas numeradas quando quem lê precisar seguir uma ordem e deixe a explicação ao lado do anexo. Não desenhe sobre o texto exato do erro nem sobre o valor que demonstra o bug.

Com uma captura ativa no Floatie, ⌘E abre o editor Pro para adicionar setas, texto e marcações numeradas. A página do recurso de edição apresenta as ferramentas.

Se o erro existir apenas como imagem, o OCR pode ajudar a copiar o texto (em inglês). Compare o texto copiado com o original, especialmente a pontuação e caracteres parecidos. Inclua no relato o texto do erro para que seja possível pesquisá-lo, além de mostrá-lo na imagem.

3. Adicione este modelo de reprodução

O exemplo abaixo é fictício; substitua-o pelas suas observações reais.

Título: Salvar continua desativado após inserir o nome do projeto

Ambiente:
- App e versão:
- Versão do macOS:
- Navegador e versão, se relevante:

Etapas:
1. Abra um projeto novo.
2. Insira um nome.
3. Tente selecionar Salvar.

Esperado: Salvar fica disponível depois que um nome válido é inserido.
Real: Salvar continua desativado.
Frequência: Reproduzido em 3 de 3 tentativas.
Anexo: salvar-projeto-desativado.png

No campo de frequência, informe o que você realmente testou. Se aconteceu uma vez, diga isso. Para um problema de layout de site, inclua o tamanho da janela ou o nível de zoom se isso afetar o resultado.

4. Escolha entre uma captura e uma gravação

Uma captura funciona para um valor incorreto, um rótulo ausente ou um layout quebrado. Uma gravação curta é melhor se um menu desaparecer, houver uma rolagem inesperada ou for importante mostrar uma sequência de cliques. Grave apenas a parte relevante da tela (em inglês) e pare quando o comportamento ficar visível.

Anexe o arquivo ao relato se ele precisar continuar disponível junto com o problema. Antes de enviar, abra o anexo e confira se o texto importante está legível. Se houver um limite de tamanho, reduza o tamanho da captura sem perder esse detalhe.

Experimente o Floatie no seu próximo relato de bug