Relatando um corte ruim de forma útil

By Support writer

Um relatório útil sobre cortes incorretos explica o que falhou, onde falhou e como reproduzi-lo. Comece com o sintoma, o formato de origem e as dimensões, a versão do navegador e da extensão, o método de entrada e se a configuração do modelo de primeira execução foi concluída.

Não envie um original privado automaticamente. Primeiro, tente reproduzir o problema com um substituto inofensivo ou um exemplo bem recortado e editado. Um relatório de suporte raramente precisa da identidade de uma pessoa, do texto do documento, da localização ou do ativo completo do cliente.

Primeiro decida se é um problema de qualidade ou uma falha

“Recorte ruim” pode significar várias coisas diferentes:

• a imagem não abria;
• o processamento nunca foi iniciado;
• o processamento travou ou parou;
• a máscara do sujeito retirou uma parte importante;
• o fundo permaneceu em torno do assunto;
• cabelos, peles, vidros ou objetos finos se partiram;
• um halo apareceu somente após a exportação;
• Falha na cópia enquanto o download funcionava;
• o resultado parecia certo no editor, mas errado em outro aplicativo.

Nomeie a categoria na primeira frase. “O identificador desapareceu após o processamento” dá ao suporte um ponto de partida. “Não funciona” não funciona.

Se o processamento for concluído e apenas a borda precisar de uma pequena correção, isso pode ser um caso normal de refinamento, e não uma falha de software. Inclua o que o resultado automático fez antes de você usar os pincéis Adicionar ou Apagar.

Grave o caminho de reprodução mais curto

Escreva as etapas como se outra pessoa precisasse segui-las em uma instalação limpa:

1. Abra a extensão na barra de ferramentas.
2. Solte um JPG local com dimensões 2400 × 1600.
3. Aguarde o término do processamento.
4. Inspecione a lacuna dentro da alça do objeto.
5. Baixe PNG.
6. Observe que a lacuna é preenchida tanto na visualização quanto na exportação.

Use apenas as etapas necessárias para atingir o sintoma. Mencione alternativas que alteram o resultado, como “o mesmo arquivo funciona quando salvo como PNG” ou “Baixar funciona, mas copiar não”.

Para um problema de imagem de página, inclua se a falha ocorre apenas por meio do clique com o botão direito e se salvar a mesma imagem localmente funciona. Alguns sites fornecem imagens de maneiras que impedem que o fluxo de trabalho da página as leia; essa evidência separa as restrições de entrega da qualidade do modelo.

Inclui detalhes do ambiente que podem mudar o comportamento

Um bloco de ambiente compacto é suficiente:

• versão de extensão;
• versão do navegador;
• sistema operacional;
• memória aproximada do dispositivo se o processamento falhar em arquivos grandes;
• se o download do modelo foi concluído;
• formato de origem, dimensões em pixels e tamanho aproximado do arquivo;
• rota de entrada: escolha, solte, cole ou imagem da página;
• rota de saída: Baixar PNG ou Copiar;
• se o problema se repete após a reabertura do editor.

Evite enviar um inventário completo do sistema. Números de série de hardware, nomes de contas, endereços de rede, listas de aplicativos instalados e histórico de navegador não relacionado geralmente adicionam riscos sem ajudar a reproduzir um defeito de borda.

Descreva a imagem geometricamente

Quando não for possível compartilhar a fonte, descreva as condições visuais:

• cabelos escuros e cacheados contra uma parede escura;
• borda de vidro transparente sobre fundo brilhante;
• raios estreitos de bicicleta atravessando uma rua texturizada;
• borda clara do produto contra um fundo esbranquiçado;
• sombra suave do chão tocando o assunto;
• captura de tela de baixa resolução com blocos de compressão;
• assunto parcialmente cortado na borda do quadro.

Mencione onde o erro aparece: borda superior esquerda, lacuna fechada, sombra de contato, área semitransparente ou borda de um pixel ao redor da exportação. Esse vocabulário é mais prático do que dizer que a modelo “não entendeu a foto”.

Use um substituto seguro quando possível

Tente recriar o mesmo problema visual com um objeto que você possa compartilhar. Se um produto do cliente tiver uma alça faltando, fotografe uma caneca simples contra um fundo semelhante. Se os detalhes particulares do cabelo falharem, use uma peruca, escova, fio ou planta com estrutura de borda semelhante.

Um substituto só é útil se reproduzir o sintoma. Deixe claro que se trata de uma reprodução e não do original. Inclua condições de sucesso e falha:

• falha em baixo contraste, funciona em alto contraste;
• falha acima de um determinado tamanho de imagem, funciona após redimensionar;
• falha através da ação de imagem de página, funciona a partir de arquivo salvo;
• a visualização está correta, o PNG exportado mostra uma margem em um visualizador local nomeado.

Essa comparação muitas vezes revela mais do que apenas o original.

Se você precisar compartilhar uma imagem, minimize-a

Obtenha a permissão do proprietário e siga primeiro qualquer política do cliente ou do local de trabalho. Em seguida, remova tudo o que a investigação não precisa:

1. Duplique o arquivo para que o original permaneça intacto.
2. Corte bem próximo da borda com falha.
3. Remova os metadados se o seu fluxo de trabalho aprovado exigir isso.
4. Edite nomes, telas, endereços, rostos e marcas de identificação fora da área relevante.
5. Confirme a redação na cópia exportada real.
6. Compartilhe apenas através da rota de feedback designada.

Pintar de preto sobre o texto pode ser inadequado se o formato do documento preservar camadas ou conteúdo oculto. Uma cópia raster achatada e bem cortada geralmente é mais fácil de raciocinar, mas siga as regras da sua organização.

Nunca envie documentos de identidade, imagens íntimas, fotos de crianças, registros médicos, credenciais ou evidências confidenciais apenas para melhorar um relatório de bug.

Capture antes e depois sem compartilhar demais

Para um relatório de qualidade extrema, um recorte aproximado de três estados pode ajudar:

• borda de origem;
• resultado automático da máscara;
• resultado desejado após refinamento manual.

Mantenha o corte grande o suficiente para mostrar o contraste e a textura locais, mas pequeno o suficiente para remover a identidade e o contexto. Rotule cada estado. Se as capturas de tela incluírem guias do navegador, favoritos, notificações, nomes de arquivos ou avatares de contas, recorte-os antes de enviá-los.

Quando o problema for exportação, inspecione o PNG contra um fundo local claro e escuro. Um halo pálido pode desaparecer no branco, permanecendo óbvio no cinza escuro. Diga se o defeito existe na visualização do editor, no arquivo exportado ou apenas na aplicação de destino.

Relate o tempo e a frequência honestamente

O tempo útil é aproximado: “o processamento trava por mais de dois minutos após o início do indicador de progresso” ou “a falha é imediata após a escolha do arquivo”. Não relate um benchmark preciso de uma corrida distraída.

Frequência do estado:

• todas as tentativas com esta amostra segura;
• duas de cinco tentativas;
• uma vez, não reproduzido após reinicialização;
• somente no primeiro lançamento;
• começou após uma atualização de extensão.

Um evento único ainda é importante, mas rotulá-lo com precisão mantém a investigação focada.

O que não incluir

Deixe de fora:

• senhas, tokens ou credenciais de conta;
• registros completos do navegador que você não revisou;
• arquivos pessoais não relacionados;
• a imagem privada original quando um corte seguro reproduz o problema;
• suposições sobre o upload do servidor baseadas apenas na observação da atividade da rede;
• alegações agressivas sobre a causa sem provas.

Descreva as observações primeiro. “O erro do trabalhador aparece após 40 segundos neste arquivo de 30 megapixels” é uma evidência. “O servidor rejeitou minha foto” é especulação, especialmente quando o caminho de recorte foi projetado para ser executado localmente.

Um modelo de relatório

Use esta estrutura compacta:

Resumo: Uma frase nomeando o objeto ou estágio com falha.
Esperado: O que deve permanecer transparente, opaco, copiado ou baixado.
Observado: O que realmente aconteceu e onde aparece.
Etapas: A reprodução com numeração mais curta.
Ambiente: Versões, sistema, estado de configuração do modelo, formato de origem e dimensões.
Frequência: Sempre, intermitente ou uma vez.
Amostra segura: Reprodução anexada, exemplo recortado ou “não é possível compartilhar”.
Solução alternativa: redimensione, reexporte, use arquivo local, refine manualmente ou nada.

Use o fluxo de feedback da extensão se sua compilação instalada fornecer um. Caso contrário, guarde o texto do relatório para poder colá-lo na rota de suporte atual sem reconstruir as evidências da memória.

Torne o relatório útil e consciente da privacidade

O relatório mais forte não é aquele com mais dados. É aquele com o menor exemplo reproduzível e o limite mais claro entre observação e suposição.

Para soluções imediatas, consulte Solução de problemas. Antes de anexar qualquer amostra, use os hábitos em Hábitos seguros de imagens de teste. Bons relatórios melhoram a qualidade do recorte sem transformar o conteúdo privado em material de apoio desnecessário.