Como reportar um defeito

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:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎Cymraeg • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎हिन्दी • ‎hrvatski • ‎Kreyòl ayisyen • ‎magyar • ‎Հայերեն • ‎interlingua • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎ಕನ್ನಡ • ‎한국어 • ‎Ripoarisch • ‎kurdî • ‎Lëtzebuergesch • ‎lietuvių • ‎মেইতেই লোন্ • ‎मराठी • ‎Bahasa Melayu • ‎Napulitano • ‎norsk bokmål • ‎Nederlands • ‎occitan • ‎ଓଡ଼ିଆ • ‎ਪੰਜਾਬੀ • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎සිංහල • ‎slovenčina • ‎shqip • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ትግርኛ • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
atalho: BUGREPORT

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 PhabricatorPhabricator para saber mais). As tarefas com textos bem redigidos irão suscitar muito mais interesse nos 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 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

Antes de fazer alguma coisa

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.

Reportar um novo defeito ou requisitar uma funcionalidade

Se encontrou um defeito numa versão recente e ninguém ainda o reportou, então:

  1. Vá a phabricator.wikimedia.org e clique «Tarefas e defeitos» na barra lateral.
  2. Escolha "Criar tarefa" no canto superior direito.
  3. Ser-lhe-á pedido que inicie uma sessão (ou se registe) se ainda não o tiver feito (veja «Criar a sua contaPhabricator/Help#Creating_your_account»).
  4. Preencha, no mínimo, os seguintes campos:
    • Titulo: Uma frase curta que explique o problema (e não a sua sugestão de resolução)
      • Bem: "Selecting gender is not functional."
      • Mal: "Software crashes."
    • Atribuído a: Deve ignorar este campo; os programadores definirão um responsável quando planearem trabalhar na tarefa.
    • Descrição: Descrição detalhada do problema, fornecendo tantos detalhes quanto possível. Isto pode incluir:
      • Para defeitos:
        • Passos para reprodução: 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. 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 a aplicação fez após executar os passos descritos acima.
          Exemplo:
          "There is no female gender in front of my user name."
        • Resultados esperados: O que a aplicação deveria ter feito se não tivesse nenhum defeito.
          Exemplo:
          "My gender is shown in front of my user name."
      • Para pedidos de funcionalidade:
        • Uma descrição daquilo que pretende ter e porquê. Uma forma eficaz de transmitir estas ideias é uma descrição de utilização.
          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 outra informação que possa ser útil, por favor, tal como:
        • os browsers, temas ou sistemas em que viu o defeito;
        • hiperligações ou listas de diferenças para uma ou mais páginas onde encontrou o defeito; ou
        • se o problema ocorre sempre, só ocasionalmente, só em certas páginas, ou só em circunstâncias específicas.
    • Para anexar um ficheiro de registos ou uma captura de ecrãHelp:Screenshots (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.
    • Selecione as etiquetas (projetos) em que encontrou o defeito:
      • 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.
      • Um exemplo é o projeto MediaWiki-General-or-Unknown para o software da própria wiki, ou Wikimedia-Site-Requests para alterações da configuração num site da Wikimedia (ver "Selecionar projetosPhabricator/Help#Selecting_projects").
    • Subscritores: Deve ignorar este campo: se souber de utilizadores específicos que têm interesse em ser notificados sobre a tarefa, pode adicioná-los aqui.

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.

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

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 não tem a certeza que uma funcionalidade que está a utilizar é baseada em JavaScript, tente desativar o JavaScript.

É sempre útil incluir uma captura de ecrã no seu relatório. Muitas vezes, esta é a forma mais fácil de identificar a funcionalidade a que o relatório se refere e frequentemente fornece informação que pode ajudar a despistar o erro. Certifique-se de que oculta todas as informações que não deseja partilhar, tal como outros separadores do browser ou janelas de conversação minimizadas.

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[1]. 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

  • phab:T85433