Obter ajuda
Onde fazer uma pergunta, comunicar um erro ou um problema de segurança, e sugerir uma melhoria
Antes de perguntar
A maior parte das respostas já está escrita; uma pesquisa rápida poupa muitas vezes uma ida e volta:
- Pesquise neste site com a caixa de pesquisa no topo de cada página.
- Procure a mensagem de erro exata em Resolução de problemas, e dê uma vista de olhos às FAQ.
- Verifique o registo do servidor (Definições e depois Registo do servidor) e a página Estado, que indicam a maior parte dos problemas de configuração.
- Verifique o Registo de alterações: o problema pode já estar corrigido numa versão mais recente.
Onde ir
Cada tipo de pedido tem o seu próprio sítio, todos no GitHub:
| Pretende | Vá a |
|---|---|
| Fazer uma pergunta ou partilhar uma ideia | Discussions |
| Comunicar um erro | New issue → Bug report |
| Sugerir uma funcionalidade | New issue → Feature request |
| Comunicar um problema de segurança | Report a vulnerability, em privado |
| Corrigir ou melhorar esta documentação | Editar esta página no GitHub no fundo de qualquer página, ou uma issue no site |
Comunicar um erro
Um relatório que possa ser reproduzido é corrigido mais depressa. O modelo de relatório de erro pede o seguinte:
- Versão : mostrada em Acerca de no menu de ajuda (?) da barra superior
- Implementação : Docker, Docker Compose, Kubernetes, o instalador (e o seu motor), uma instalação nativa ou a partir do código-fonte
- Passos para reproduzir : o que fez, o que esperava e o que aconteceu em vez disso
- Evidências : as linhas relevantes do registo do servidor, e uma captura de ecrã quando o problema é visível
Para um problema com um formulário, inclua uma definição de formulário mínima que o mostre. Retire as palavras-passe, os tokens, os nomes de hosts e quaisquer outros dados privados dos registos e dos formulários antes de os publicar: as issues e as discussões são públicas.
Comunicar um problema de segurança
Nunca abra uma issue pública para isso: use Report a vulnerability, que só os maintainers veem.
A política de segurança lista as versões suportadas e o que acontece depois de comunicar.