Reportar Erro

Antes de reportar um erro

• Por favor certifique-se que consegue reproduzir o erro e identificar os passos necessários para o desencadear.
  Idealmente utilize um ficheiro novo vazio (que pode mais ser tarde útil como ficheiro de teste) e tente também reproduzir após repor as definições de origem do Inkscape (mais informação). Isto confirmar-lhe-á que o problema está onde pensa, e não é relacionado com nenhuma definição específica do programa. Se não o consegue reproduzir por si próprio, por favor aguarde até conseguir isolar o problema antes de o reportar.

  Ocasionalmente erros que ocorrem apenas num ficheiro específico (e não num novo ficheiro em branco) são interessantes para os programadores. No entanto se for um principiante por favor discuta o problema com utilizadores mais avançados (no forum, IRC ou na lista de correio) antes de criar um novo relatório de erro. Principiantes devem discutir quaisquer potenciais erros com outros utilizadores antes de reportar. Veja abaixo.

• Procure na listagem de erros para se certificar que o erro não foi já reportado:

  1. Antiga listagem de erros no Launchpad:
     Esta tem sido o nossa listagem de erros principal durante anos, por isso é provável que o seu erro já esteja lá listado. O antigo relatório pode conter informação adicional. Verifique se o problema ainda está presente na mais recente versão do Inkscape. Se estiver por favor ajude-nos a transferir o relatório de erro para o GitLab, onde iremos acompanhar erros de futuro. Tente resumir a informação técnica do relatório o melhor possível. Mantenha o resumo conciso e inclua uma ligação para o antigo relatório no Launchpad

  2. Listagem no GitLab (veja a ligação e instruções abaixo):
     Certifique-se absolutamente que o erro não foi ainda reportado aqui antes de submeter um novo relatório ou transferir um anterior. Se o relatório já existir, adicione um comentário ao existente com quaisquer novas ou potencialmente úteis informações que possa contribuir. Se pretende apenas indicar que a correcção do erro é importante para si submeta apenas um voto, utilizando os pequenos ícones de votação abaixo da descrição. (Evite comentários do género "Eu também!" ou "+1" porque dificultam aos programadores encontrar informação técnica relevante).
     Se encontrar relatórios relacionados, que possam ajudar os programadores a corrigir o erro, também nos é útil se publicar uma ligação para os mesmos. Se acabar por submeter um novo relatório de erro clarifique de que forma o seu erro difere dos relatórios existentes.

Todos os relatórios de erro devem conter a seguinte informação

• Uma descrição precisa do problema (isto é concisa e precisa, mas contemplando todos os detalhes possíveis), em Inglês, incluindo:

  • Instruções passo a passo que reproduzam o problema de forma fiável.
  • O comportamento do programa (o que realmente aconteceu)
  • O comportamento esperado do programa (o que deveria ter acontecido)
  Se pretende aprender como escrever um "bom" relatório de erro que é mais útil para os programadores veja a esclarecedora dissertação "How to Report Bugs Effectively" por Simon Tatham (criador do PuTTY).

• A Versão do Inkscape em utilização (menu Ajuda > Acerca do Inkscape por exemplo "Inkscape 0.92.3 (2405546, 2018-03-11)")
  Liste ainda todas as anteriores versões em que o problema também ocorreu, bem como as versões que não manifestam o problema, se conseguir essa informação.

• O sistema operativo em utilização.

Relatórios de erro devem opcionalmente incluir o seguinte, caso possa ajudar os programadores a perceber melhor o problema

• Um ficheiro SVG de teste contendo tudo o necessário a demonstrar o problema e nada mais (exemplar minimalista de testes)

• O mesmo noutro formato de ficheiro, no caso do problema ser relacionado com a abertura, gravação, importação ou exportação de/para outro formatos que não SVG

• Capturas de ecrã, vídeos ou animações mostrando a aparência do problema, no caso de um ficheiro de demonstração não ser apropriado, ou insuficiente por si só para demonstrar o problema. Pode também ser útil imagens de "antes e depois" do problema.

• A linguagem do interface do utilizador do Inkscape e do sistema operativo, (especialmente se o relatório de erro estiver relacionado com traduções, caracteres especiais no documento, nomes de ficheiros, etc.)

• O método de instalação, e a versão exacta do instalador, se o problema for relacionado com instalação, actualização e/ou correr o Inkscape.

Porque é toda esta informação importante?

Porque os programadores devem ser capazes de reproduzir o erro antes de poderem começar a corrigir o problema. No Inkscape os erros podem ser específicos de certas versões, ou determinados sistemas operativos, (bem como certas combinações dos mesmos) ou ocasionalmente certas linguagens. Enquanto que um ficheiro de demonstração não é necessariamente um requerimento ou nem sempre é apropriado, tudo o que os submissores do relatório de erro possam fazer para facilitar a vida dos programadores é bem vindo.

Todos os programadores do Inkscape são voluntários. Trabalham no Inkscape no seu tempo livre, após o seu dia de trabalho, divertimento, família e actividades pessoais. Tudo o que os submissores possam fazer que lhes facilite a vida aumenta a possibilidade de o erro vir a ser corrigido.

Outras responsabilidades dos submissores de relatórios de erro

• Permanecer disponível para responder aos programadores sobre o seu relatório.
  Irá receber uma notificação sempre que alguém publicar um comentário, ou simplesmente alterar uma categoria, classificação ou avaliação do seu relatório. Podem ser-lhe solicitadas clarificações, ou que forneça outros ficheiros, imagens ou documentação. Lembre-se sempre que tudo que possa fazer para ajudar os programadores irá aumentar a probabilidade da resolução do problema.

• Seja paciente e mantenha-se positivo
  Quando relata um erro, fá-lo porque quer que o mesmo seja corrigido. Nós queremos o mesmo! Uma vez que o Inkscape é desenvolvido por voluntários no seu tempo livre, pode levar algum tempo até que alguém dê atenção ao seu relatório (pode levar entre horas a anos). Em qualquer dos casos seja sempre tão atencioso e respeitoso quanto possível (mesmo quando os programadores possam parecer frios da sua perspectiva ;-) ) uma vez que as pessoas geralmente sentem-se mais motivadas para trabalhar e o problema será resolvido mais depressa.

Reporte o erro, ou faça um pedido de novas funcionalidades

Por favor reporte novos erros que encontre nas actuais versões do Inkscape na nova Listagem de Erros do Inkscape no Gitlab orientada para o utilizador.

Atenção: É necessário registar uma conta de utilizador no GitLab para poder comentar ou criar novos relatórios.

Se é um novo utilizador do Inkscape, ou mesmo de nível intermédio pode ser uma boa idea publicar o problema que encontrou numa das listas de correio (lista de correio dos programadores ou da comunidade de utilizadores), ou num dos forums (listagem nesta página), para discutir o problema directamente. Outra opção é um dos Canais IRC.  Frequentemente utilizadores mais avançados serão capazes de determinar se é um erro conhecido ou se é mesmo um erro de todo. Se for um erro conhecido poderá pesquisar, e aprender mais sobre o erro. Através da discussão poderá aprender formas de contornar o problema.

Novas funcionalidades, ou items de listas de pedidos podem também ser submetidas através do sistema de listagem de erros. Mais uma vez, se for um novo utilizador Inkscape, poderá querer discutir a sua idea numa das listas de correio, ou nos forums, para perceber como se pode integrar na visão dos programadores para o Inkscape, antes de submeter o relatório/pedido.