Gerenciamento de Erros do Inkscape

Os bugs do Inkscape são relatados e gerenciados no GitLab (rastreador voltado para o usuário; rastreador voltado para o desenvolvedor) e no rastreador legado no Launchpad. Os usuários podem criar e comentar relatórios de bugs e designar-se para trabalhar em um determinado bug. Os membros da equipe de bugs do Inkscape podem atribuir prioridades e rótulos.

URLs importantes

• Erros do Inkscape no Launchpad (eles precisam ser transferidos para o GitLab) - inicie o gerenciamento de erros aqui.
• Erros do Inkscape no GitLab
• Equipe de Erros do Inkscape - entre em contato com os desenvolvedores na lista de discussão ou no bate-papo para se tornar um membro da Equipe de Erros.

Situação dos Erros

O Launchpad tem vários status para os erros. Sua utilização no Inkscape é explicada aqui.

• New: este erro que foi apenas relatado, e não se sabe se é reprodutível. Tente reproduzir este erro no seu computador.
• Confirmed: este erro foi reproduzido e verificado como sendo causado pelo Inkscape. Você pode trabalhar em localizá-lo e corrigi-lo.
• Triaged: um membro da Equipe de Erros verificou o problema e atribuiu-lhe um grau de importância. Os desenvolvedores do Inkscape aceitam que eles vão trabalhar para resolver o problema.
• In Progress: alguém está trabalhando agora para corrigir o erro. Não use esse status para indicar que você está disposto a trabalhar em um determinado problema, ou que que você irá trabalhar nele algum tempo posteriormente; apenas defina-o se você realmente começou a trabalhar na correção.
• Fix Committed: o erro foi corrigido na versão de desenvolvimento (ramo lp:inkscape). Se você subiu uma correção, mas não tem certeza se ela funciona, por exemplo, se o problema só acontece em uma plataforma que você não tem acesso, deixe como "In Progress".
• Fix Released: o erro foi corrigido na última versão estável do Inkscape. Também use esse status para erros que apareceram apenas na versão de desenvolvimento e nunca foram encontrados em uma versão estável.
• Incomplete: foram fornecidas informações insuficientes pelo relator do problema para identificar ou reproduzir o erro. Se ninguém mais encontrar um problema semelhante, ele será marcado como inválido depois de algum tempo.
• Invalid: este problema não é culpa do Inkscape, ou o relator não respondeu a pedidos para obter mais informações.
• Won't Fix: questão que nunca será corrigida no Inkscape devido a opções de design ou porque está fora do escopo do programa. Um exemplo pode ser um pedido de edição de clipes de áudio ou reescrever o Inkscape em uma linguagem diferente.

A importância do erro

A importância reflete o quão sério é o problema.

• Critical: comportamento incorreto muito grave que afetarão severamente a maioria dos usuários. Exemplos: falhas reproduzíveis após uma ação comum; perda de dados do documento; corrupção de dados do documento; regressões graves na funcionalidade; compilação quebrada em mais de uma plataforma (Linux, Mac, Windows, outros)
• High: comportamento incorreto grave que é suscetível de afetar uma grande parte dos usuários. Exemplos: falha reproduzível após uma sequência incomum de ações; outra perda de dados do usuário (por exemplo, corrupção do arquivo de preferências); saída em não conformidade com SVG; Documentos compatíveis com SVG mal interpretados; arquivo de saída incorreto; vazamento de memória principal; compilação quebrada em uma única plataforma
• Medium: comportamento incorreto moderadamente grave que é suscetível de afetar muitos usuários. Exemplos: travamento em circunstâncias muito obscuras ou improváveis; interface do usuário não aderindo às diretrizes padrão; qualidade de renderização abaixo do padrão; mau desempenho; vazamento de memória menor; problemas de compilação em plataformas exóticas, mas atualizadas
• Low: peculiaridade ou desvio do comportamento esperado que pode afetar uma pequena parte dos usuários. Exemplos: peculiaridades menores na renderização; localização inconveniente de comandos; comportamento inconveniente ou limitação da funcionalidade de um comando existente; mau desempenho durante operações obscuras; tradução incorreta; problemas de compilação em plataformas desatualizadas
• Wishlist: falta de funcionalidades que podem incomodar alguns usuários. Exemplos: nenhum recurso de auto-salvamento; exportar para um formato exótico de arquivo não suportado; arrastar e soltar entre Inkscape e Microsoft Word

Tags

As tags atribuem categorias aos problemas relacionados por subsistema, plataforma ou uma área geral da funcionalidade do Inkscape. Elas são particularmente úteis para os desenvolvedores que trabalham em uma área específica do código e pretendem corrigir vários erros de uma só vez. Aqui está a lista incompleta das tags mais importantes.

• blocker: Um erro deve ser corrigido antes de um lançamento ser feito.
• crash: Erro acidental.
• regression: Algo que funcionou em uma versão anterior não está mais funcionando.
• linux: Problema ocorre apenas no Linux.
• win32: Problema ocorre apenas no Windows.
• osx: Problema ocorre apenas no Mac OS X.

Recomendações

A metodologia geral para trabalhar com erros é a seguinte:

Seja educado. É preciso algum esforço por parte do utilizador para vir ao nosso site, navegar até a seção do relatório de erros e escrever um relato. Se eles souberem que seu relatório será tratado seriamente e profissionalmente, eles vão respeitar o sistema e colocar em tempo extra para nos ajudar a resolver o problema.

Não feche um erro não reproduzível a menos que uma quantidade razoável de esforços tenha sido colocada em reproduzi-lo e deixá-lo apodrecer por algum tempo antes de fechar -- alguém pode vir acima com um relatório melhor nos comentários. (Em algumas situações não fomos capazes de recriar o problema, mas devido ao apoio do usuário envolvido fomos capazes de amenizar e corrigir o problema, e o usuário foi capaz de fazer a validação.)

Esclareça. Se você levou um certo tempo para adivinhar do que se trata, mude o resumo ou adicione comentários, seja óbvio para quem estará lendo o rastreador de falhas depois de você (especialmente se é a pessoa que poderá solucioná-lo). Por exemplo "erro de rolagem bizarra" deve ser substituído por "peculiaridade de renderização quando feita rolagem enquanto arrasta máscara de clone", e "Inkscape trava neste arquivo" com "travamento ao arrastar parada de gradiente do clone pai".

Ao fechar um erro como Fix Committed, adicione um comentário que inclui o número da revisão da primeira versão sem o erro. Para erros que apareceram somente em uma versão de desenvolvimento e foram corrigidos antes que uma versão estável tenha sido feita, defina-os para "Fix Released" logo após eles serão corrigidos no tronco.

Sempre procure solicitações semelhantes ou duplicadas antes da apresentação de novos relatórios. Quando escolher qual relatório deve ser marcado uma duplicata e qual deixou como válido, os relatórios mais antigos devem ter prioridade sobre os mais recentes. Exceções podem ser feitas se o relatório mais recente tem informações fornecidas significativamente melhores. Quando apropriado, copie e cole qualquer informação extra relevante como um comentário para o relatório de erro sendo deixado aberto.