Como investigar um problema e preparar um relato útil para o suporte?

Registre o contexto e a mensagem, verifique as causas observáveis e encaminhe evidências suficientes para reproduzir o problema.

Antes de começar

• Registre a mensagem exibida, a tela em que ocorreu e a ação que estava realizando.
• Confira a conta, as permissões do recurso e os filtros ativos antes de repetir o procedimento.

Passo a passo

1. Anote conta, área, recurso e ação que estava executando.
2. Registre a mensagem exata e o comportamento esperado.
3. Confira filtros, papel, estado do recurso e confirmação de salvamento.
4. Verifique se o recurso depende de navegador, integração ou serviço externo.
5. Descreva os passos mínimos de reprodução e informe se o problema acontece sempre ou apenas em um contexto.

Informações importantes

Não apague armazenamento local para testar sem preservar os dados e entender a origem da persistência. Não envie senhas, tokens ou dados de outras pessoas no relato.

Aplicação no dia a dia

Um bom relato informa: ao abrir a tarefa pelo projeto X, com papel Y, o controle Z fica desabilitado; a tarefa pode ser consultada, o projeto está ativo e a mensagem é esta. Isso ajuda a distinguir restrição prevista de falha.

Dúvidas frequentes

Por onde começar quando uma função do Tark não funciona?

Comece identificando a ação, o contexto, a conta e a mensagem, para distinguir erro de configuração, acesso e dados.

Como diferenciar falta de acesso, item inexistente, item arquivado e item na lixeira?

Sem acesso, inexistente, arquivado e lixeira são estados diferentes e possuem orientações próprias.