Como reportar um bug

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to report a bug and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎ਪੰਜਾਬੀ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어
atalho: BUGREPORT

Estas diretrizes explicam como escrever um relatório de falhas ou um pedido para novas funcionalidades (uma tarefa) no centro de gestão de tarefas Wikimedia (consulte Phabricator para saber mais). As tarefas com textos bem redigidos irão criar muito mais interesse por parte dos voluntários em colaborar na sua resolução.

As tarefas têm de ser redigidas em inglês. Se não sabe escrever em inglês, tente utilizar uma ferramenta de tradução automática como o Tradutor da Google.

Recomendações rápidas

  • Seja preciso
  • Seja claro: explique como reproduzir o problema, passo a passo, de modo que outras pessoas possam reproduzir a falha ou consigam compreender o pedido.
  • Inclua apenas um problema por tarefa
  • Inclua hiperligações relevantes e exemplos

Antes de fazer qualquer coisa

Você pode reproduzir o problema?

Tente reproduzir o problema usando uma versão recente do software, para atestar se já foi consertado. Se o problema estiver em uma wiki como o Wikipédia, você pode testar a última versão do software em test2.wikipedia.org.

Outra pessoa já relatou esse erro?

Use a caixa de busca no rastreador de bugs da Wikimedia para ver se o problema já foi relatado. Você também pode fazer buscas mais avançadas na página de buscas.

Se você não tem certeza se um erro já foi relatado, é preferível que você o relato. É melhor ter erros duplicados do que erros não relatados.

Você já tentou corrigir o problema sozinho?

Alguns problemas são consequência do uso de scripts e gadgets de usuários que precisam de algumas correções. Há um guia disponível com etapas de como você pode identificar esse código, o que pode corrigir seu problema para que você não perca tempo relatando-o.

Relatando um novo bug ou requisição de nova funcionalidade

Se você encontrou um erro em uma versão recente e aparentemente ninguém o relatou, então:

  1. Acesse phabricator.wikimedia.org e clique em "Tarefas & erros" na barra lateral.
  2. Você deverá fazer login (ou se cadastrar) caso não tenho o feito ainda (veja "como criar sua conta ").
  3. Clique no botão estrela no canto superior direito e escolha "Criar Tarefa" (ou "Reportar problemas de Segurança" para report a security problem ).
  4. Preencha, no mínimo, os seguintes campos:
    • Title: uma frase curta que explique o problema (não é sua sugestão de solução).
      • Bom: "Selecting gender is not functional."
      • Ruim: "Software crashes."
    • Assigned to: você pode ignorar este campo. Os desenvolvedores definirão um responsável, quando planejarem trabalhar na tarefa.
    • Description: todos os detalhes sobre o erro, o máximo possível. Isso pode incluir:
      • Para bugs:
        • Passo à passo para reproduzir: pequenos passos, fáceis de seguir, que iniciarão o erro. Inclua qualquer configuração especial necessária.
          Exemplo:
          1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • Resultados reais: o que o aplicativo fez após os passos descritos acima.
          Exemplo:
          "There is no female gender in front of my user name."
        • Resultados esperados: o que o aplicativo deveria ter feito se não houvesse erro.
          Exemplo:
          "My gender is shown in front of my user name."
      • Para solicitações de recursos:
        • Uma descrição do que você gostaria de alcançar, e por quê. Um [$story histórico de usuário] é uma maneira eficaz de transmitir isso. Explique o que você espera que a ferramenta resolverá (o atual problema desconhecido) com exemplos específicos; mas que não demandam soluções específicas, de forma que possam haver outras/melhores soluções. Um user story é uma forma efetiva de mover isto.
          Exemplo:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • Forneça também qualquer informação que seja útil, tal como:
        • os navegadores, temas (skins), ou sistemas em que você o viu o problema ocorrer;
        • ligações ou difs para uma ou mais páginas em que você encontrou o problema; ou
        • se o problema aparece sempre, apenas de vez em quando, apenas em certas páginas, ou apenas em circunstâncias específicas.
    • Attachment você pode anexar um arquivo ou captura de tela (certifique-se de que nenhuma informação confidencial está incluída ou sendo mostrada), clique no botão Upload file na barra de ferramentas do campo Description.
    • Selecione tags (projeto(s)) de onde você achou o problema:
      • Projetos são como os desenvolvedores encontrarão as tarefas para trabalhar em cima do relato. Para identificar o(s) projeto(s) correto(s), use uma função de busca (na parte superior direita) para encontrar sua descrição.
      • Por exemplo, o MediaWiki-General-or-Unknown para o software wiki, ou Wikimedia-Site-Requests para mudanças de configuração nos sites da Wikimedia (veja Selecting projects ).
    • Subscribers: Se você conhece usuários específicos que estarão interessados em ser notificados sobre esta tarefa, você pode adicioná-los aqui. Caso contrário, ignore este campo.

Certifique que seu relato está completo, então pressione o botão "Create task". Seu relato agora estará na base de dados. Isto permite que alguém interessado no relato veja-o e potencialmente trabalhe nisso .

A prioridade para a tarefa será decidida pelos desenvolvedores que desejarem trabalhar nela (ver Estabelecendo prioridades).

Pronto! Obrigado por ajudar a melhorar os projetos do MediaWiki e da Wikimedia!

Relatando um problema relacionado à JavaScript

"Ver também: Ajuda:Localizando scripts quebrados"

Muitas funcionalidades, como gadgets, scripts de usuário e algumas partes do MediaWiki, contam com 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 todas as informações que você tiver, porque mesmo os administradores do sistema terão acesso zero a qualquer log de erro.

Se o problema estiver localizado no código de um usuário ou de um gadget propriamente dito, então o Phabricator pode não ser o local onde o problema será gerido[1]. Alguém poderá redirecioná-lo para a página de discussão dessa sequência de comandos (se a sequência problemática tiver sido identificada).

Reportar um erro de conectividade

Se você está tendo dificuldade para acessar um website da Wikimedia (conexão à internet lenta etc.), por favor dirija-se a wikitech:Relatando um erro de conectividade.

Reportar um problema de login

Se você estiver tendo problemas para fazer login na sua conta, siga Manual:How to debug/Login problems.

Ver também

  • phab:T85433