Algo não funciona, ou você tem uma ideia? Conte em público, na página de issues do projeto. Esta página diz o que incluir, o que deixar de fora e o que esperar.
Onde relatar
- Olhe antes a Solução de problemas: a solução pode já estar lá.
- Confira o que já foi relatado. Se o seu problema está lá, acrescente o que você vê.
- Se não estiver, abra uma issue nova. É preciso ter uma conta no GitHub.
Escreva no idioma que preferir. A resposta vem no idioma em que a issue foi escrita.
O que faz um bom relato
- O que você esperava, e o que aconteceu no lugar. "O texto foi para a área de transferência em vez de entrar no documento" tem solução. "Não funciona" não tem.
- O app em que você estava ditando. A colagem se comporta diferente num navegador, num editor de código e num app de conversa, e esse costuma ser o detalhe decisivo.
- Os passos, em ordem, do toque no atalho até o que você viu.
- Se acontece sempre, ou só às vezes.
- O seu sistema e a versão dele: macOS 14, 15…, ou Windows 10 ou 11.
- A versão e o build do app. Abra Sobre o Open Whisper no menu e copie a linha Versão … (build …): dá para selecioná-la.
- O seu modo e o seu atalho, se o problema for na gravação: Pressionar para falar ou Alternar.
- Para a linha de comando: o comando que você rodou, o código de saída e a última linha que ele mostrou.
Deixe o texto privado de fora
Se o problema está nas próprias palavras (um nome sempre escrito errado, um idioma trocado), invente uma frase que mostre isso e dite essa frase.
O que esperar
- Toda issue é lida e respondida.
- Uma recusa sempre vem com um motivo concreto. "Fora do escopo", sozinho, não é resposta.
- Nenhuma data é prometida, nunca. "Aceito e na fila" é o máximo.
- Quando algo que você relatou sai, você é avisado na sua issue.
- Se uma correção não se sustentar, reabra a issue.
O que as etiquetas querem dizer
Cada issue recebe etiquetas que dizem em que pé ela está.
| Etiqueta | Quer dizer |
|---|---|
triage: pending | Recebida, ainda não analisada |
triage: accepted | É real, e está na fila |
triage: needs-info | Esperando alguma informação sua |
triage: under-review | Precisa de uma decisão de produto antes de uma resposta |
triage: duplicate | Já relatada: o link aponta para a original |
triage: out-of-scope | Recusada, com um motivo concreto nos comentários |
status: queued | Aceita e esperando a vez |
status: in-progress | Em andamento |
status: awaiting-release | Corrigida, esperando uma versão que a traga |
status: shipped | Disponível numa versão publicada |
status: closed-unresolved | Fechada sem correção, com o motivo explicado |
Uma ideia que esbarra em algo que o Open Whisper deliberadamente não faz é avaliada, não fechada de cara: veja O que o Open Whisper não faz.