• Immutable Page
  • Info
  • Attachments

ConteúdosDeAjuda > AjudaParaProgramadores > AjudaNaCriaçãoDePatches

Descobriu uma forma de corrigir uma falha, e gostava que o desenvlvimento do moin incluisse a sua correcção, mas não sabe como criar uma patch. Veja como:

Como criar uma patch

  1. Obtenha a versão mais recente da fonte e edite-a. O tópico DesenvolvimentoDoMoin/MercurialGuide será uma boa ajuda.

  2. Antes de continuar, responda às seguintes questões:
    • A patch é útil à maioria dos utilizadores? Uma funcionalidade pode ser útil para ser e não o ser necessariamente para todos.
    • É à ManeiraDoWiki? Fazer algo à ManeiraDoWiki terá mais hipóteses de ser incluído do que fazê-lo de outra forma.

    • É uma boa patch? Código limpo, de fácil leitura e compreensão tem mais hipóteses de ser incluído.
    • Testou bem o código? Alguns membros do grupo MoinCoreTeamGroup gostam que todos os códigos sejam testados, e não ficarão satisfeitos ao incluir novos códigos sem que sejam testados.

  3. Tenha também em consideração:
    • Crie extensões se possível!

    • Patches pequenas e separadas de forma limpa têm mais hipóteses de ser incluídas do que as maiores e confusas.
    • Código bem documentado. Para poupar tempo, utilize código claro que se auto-explica. :-)

    • Documentação para o utilizador - se adicionar uma funcionalidade, adicione documentação para o utilizador.
    • Código fácil de gerir - alguém (você ou outro programador) terá de gerir o código. Deve ser fácil de gerir, uma vez que não temos tempo para isto.

Patches para a actual versão em desenvolvimento

Só serão incluídas se:

  • corrigir uma falha,
  • adicionar uma funcionalidade menor (mas útil),
  • não introduzir novas falhas e
  • for uma patch pequena e limpa.