How to report a bug/pt

Jason Strawder Estas diretrizes explicam como escrever um bom relatório de defeitos ou um pedido de novas funcionalidades (uma tarefa) no centro de gestão de tarefas da Wikimedia (consulte para saber mais). As tarefas com textos bem redigidos irão suscitar muito mais interesse nos voluntários em colaborar na sua resolução.

Recomendações rápidas para relatórios

 * Seja preciso
 * Seja claro: explique como reproduzir o problema, passo a passo, de modo a que as outras pessoas consigam reproduzir o defeito ou compreender o pedido.
 * Inclua apenas um problema por tarefa
 * Inclua quaisquer hiperligações e exemplos relevantes
 * Be clear: explain 1) how to reproduce the situation, step by step, without leaving any room for interpretation, 2) expected behavior, 3) actual behavior. In separate sections
 * Include only one problem per task
 * Include any relevant links and examples

Consegue reproduzir o problema?
Tente reproduzir o defeito usando uma versão recente do software, para ver se ele já foi corrigido. Se o defeito está num site como a Wikipédia, pode tentar testar a última versão do software em test2.wikipedia.org.

Alguém já reportou o problema?
Use a caixa de pesquisa do gestor de defeitos da Wikimedia para ver se o defeito já foi reportado ou se a funcionalidade já foi pedida. Pode também fazer pesquisas mais avançadas na página de pesquisa avançada.

Se não tiver a certeza se um defeito já foi reportado, deve reportá-lo. É melhor ter defeitos reportados em duplicado do que ter defeitos não reportados.

Is it maybe a gadget / user script issue?
Alguns problemas são consequência do uso de scripts e gadgets do utilizador que precisam de algumas correções. There is with steps how you can identify such code, which could fix your issue so that you do not waste your time reporting it.

Reportar um novo erro (bug) ou solicitar uma funcionalidade
Se encontrou um erro numa versão recente e ainda ninguém o reportou, então:
 * 1) Vá para phabricator.wikimedia.org.
 * 2) Ser-lhe-á pedido que inicie uma sessão (ou se registe) se ainda não o tiver feito (veja «»).
 * 3) Click the Bookmark button in the upper right corner and choose "Create Task" (or "Report Security issues" to ).
 * 4) Preencha, no mínimo, os seguintes campos:
 * 5) * Title: Uma frase curta que explique o problema (e não a sua sugestão de resolução)
 * 6) ** Bom:
 * 7) ** Mau:
 * 8) * Assigned to: deverá ignorar este campo: os programadores irão atribuir um responsável quando eles planearem trabalhar na tarefa.
 * 9) * Descrição: detalhes completos do problema, fornecendo tantos detalhes quanto possível. Isto deveria incluir:
 * 10) ** Para erros (bus):
 * 11) *** Steps to Reproduce: Lista com o mínimo de passos, fáceis de executar, que desencadeiam o problema descrito. Inclua quaisquer passos especiais de preparação.
 * Exemplo:
 * 1) *** Actual Results: O que a aplicação fez após executar os passos descritos acima.
 * Exemplo:
 * 1) *** Expected Results: O que a aplicação deveria ter feito se não tivesse nenhum defeito.
 * Exemplo:
 * 1) ** Para pedidos de funcionalidade:
 * 2) *** Uma descrição daquilo que pretende ter e porquê. Explain what you hope the feature will solve (the actual underlying problem) along with specific examples; but do not demand a specific solution, as there might be other/better solutions. A user story is an effective way of conveying this.
 * Exemplo:
 * 1) ** Forneça também qualquer outra informação que possa ser útil, por favor, tal como:
 * 2) *** os navegadores, temas ou sistemas operacionais em que viu o defeito;
 * 3) *** hiperligações ou listas de diferenças para uma ou mais páginas onde encontrou o defeito; ou
 * 4) *** se o problema ocorre sempre, só ocasionalmente, só em certas páginas, ou só em circunstâncias específicas.
 * 5) * Para anexar um ficheiro de registos ou uma (mas certifique-se de que não inclui nem mostra dados confidenciais), clique o botão Carregar ficheiro (uma nuvem com uma seta) na barra de ferramentas do campo Descrição.
 * 6) * Selecione as etiquetas (projetos) em que encontrou o defeito:
 * 7) ** Os projetos são o mecanismo que os programadores usam para encontrar tarefas. Para identificar o projeto correto, use a função de pesquisa (em cima, à direita) para encontrar a descrição do mesmo.
 * 8) ** Isto poderia ser por exemplo o projeto do para o software da própria wiki, ou o  para alterações da configuração num site da Wikimedia (consulte ).
 * 9) * Subscribers: Se souberes de utilizadores específicos que têm interesse em ser notificados sobre a tarefa, pode adicioná-los aqui. Caso contrário, ignore este campo.
 * 1) *** os navegadores, temas ou sistemas operacionais em que viu o defeito;
 * 2) *** hiperligações ou listas de diferenças para uma ou mais páginas onde encontrou o defeito; ou
 * 3) *** se o problema ocorre sempre, só ocasionalmente, só em certas páginas, ou só em circunstâncias específicas.
 * 4) * Para anexar um ficheiro de registos ou uma (mas certifique-se de que não inclui nem mostra dados confidenciais), clique o botão Carregar ficheiro (uma nuvem com uma seta) na barra de ferramentas do campo Descrição.
 * 5) * Selecione as etiquetas (projetos) em que encontrou o defeito:
 * 6) ** Os projetos são o mecanismo que os programadores usam para encontrar tarefas. Para identificar o projeto correto, use a função de pesquisa (em cima, à direita) para encontrar a descrição do mesmo.
 * 7) ** Isto poderia ser por exemplo o projeto do para o software da própria wiki, ou o  para alterações da configuração num site da Wikimedia (consulte ).
 * 8) * Subscribers: Se souberes de utilizadores específicos que têm interesse em ser notificados sobre a tarefa, pode adicioná-los aqui. Caso contrário, ignore este campo.

Verifique que o seu relatório está completo e depois clique o botão «Criar tarefa». O seu relatório passará a estar na base de dados e espera-se que alguém o enderece em breve. This allows somebody interested in the report to look at it and.

A prioridade da tarefa será definida pelos programadores que planearem trabalhar nela (ver Definir prioridades).

É tudo! Obrigado por ajudar a melhorar os projetos MediaWiki e Wikimedia!

Reportar um defeito de JavaScript

 * Ver também: Help:Localizar ficheiros de comandos (scripts) incorretos

A lot of functionality, such as gadgets, user scripts, and some parts of MediaWiki, rely on JavaScript.

Quando encontra um defeito que pode estar relacionado com JavaScript, faça os possíveis por identificar as mensagens de erro e copiá-las para o relatório do defeito.

É especialmente importante fornecer toda a informação que tiver, porque nem mesmo os administradores do sistema têm acesso a qualquer relatório de erro.

Se o problema estiver localizado no código de uma sequência de comandos (script) de um utilizador, ou de um gadget, então o Phabricator pode não ser o sítio onde o problema será gerido. Alguém poderá direcioná-lo para a página de discussão dessa sequência de comandos (se a sequência problemática tiver sido identificada).

Reportar um problema de conectividade
Se está a ter dificuldades em aceder a um site da Wikimedia (ligação lenta à Internet, etc.), siga wikitech:Reportar um problema de conectividade, por favor.

Reportar um problema em iniciar uma sessão
Se está a ter problemas para entrar na sua conta, siga Manual:Como despistar defeitos/Problemas em iniciar uma sessão, por favor.

Ver também

 * Como reportar defeitos de forma efetiva, de Simon Tatham
 * Como conseguir que a comunidade de desenvolvimento resolva o seu problema, de User:MSchottlender-WMF, julho 2017
 * Wikimedia and Etiqueta no Phabricator
 * Gestão de defeitos/Ciclo de vida dos relatórios de defeitos
 * Escrever um bom relatório de defeito ou pedido de funcionalidade
 * Como criar um bom primeiro relatório de defeito (desatualizado)
 * Wikipédia:Relatórios de defeitos e pedidos de funcionalidade