Ubuntu logo

Packaging Guide

6. Buscando revisão e orientação

Uma das maiores vantagens de usar o fluxo de trabalho UDD é melhorar a qualidade buscando revisão de alterações por seus pares. E isto acontece mesmo que você não tenha privilégios de envio. É claro, se você não tem privilégios de envio, você deverá buscar orientação.

Uma vez que você esteja satisfeito com a sua correção, e tem um ramo pronto, os passos seguintes podem ser usados para publicar seu ramo no Launchpad, vinculá-lo a um relatório de erro e criar uma proposta de mesclagem para os outros revisarem e para os orientadores enviarem.

6.1. Enviando para o Launchpad

We previously showed you how to associate your branch to the bug using dch and bzr commit. However, the branch and bug don’t actually get linked until you push the branch to Launchpad.

Não é essencial que você tenha um link para um erro para cada modificação que você faça, mas se você estiver corrigindo erros relatados, então fazer links para eles será conveniente.

A forma geral do URL para o qual você deve enviar o seu ramo é:

lp:~<user-id>/ubuntu/<distroseries>/<package>/<branch-name>

For example, to push your fix for bug 12345 in the Tomboy package for Trusty, you’d use:

$ bzr push lp:~subgenius/ubuntu/trusty/tomboy/bug-12345

O último compenente do caminho é arbitrário, depende de você escolher algo significativo.

Entretanto, isto normalmente não é suficiente para conseguir desenvolvedores do Ubuntu para revisar e orientar a sua alteração. Você deve então enviar uma proposta de mesclagem.

Para fazer isto, abra a página do erro em um navegador, p. ex.:

$ bzr lp-open

Se isso falhar, então você pode usar:

$ xdg-open https://code.launchpad.net/~subgenius/ubuntu/trusty/tomboy/bug-12345

where most of the URL matches what you used for bzr push. On this page, you’ll see a link that says Propose for merging into another branch. Type in an explanation of your change in the Initial Comment box. Lastly, click Propose Merge to complete the process.

As propostas de mesclagem para ramos de pacotes fonte irão inscrever automaticamente no grupo “~ubuntu-branches”, o que deve ser suficiente para contactar um desenvolvedor Ubuntu que pode revisar e orientar a sua alteração de pacote.

6.2. Gerando um debdiff

Conforme percebido acima, alguns orientadores ainda preferem revisar um debdiff anexo a relatórios de erro em vez de uma proposta de mesclagem. Se você for solicitado a incluir um debdiff, você pode gerar um como este (de dentro do seu ramo “bug-12345”):

$ bzr diff -rbranch:../tomboy.dev

Outra maneira é abrir a proposta de mesclagem e baixar o diff.

Você deve se assegurar que o diff tem as alterações esperadas, nem mais nem menos. Nomeie o diff apropriadamente, p. ex., “foobar-12345.debdiff” e anexe-o ao relatório de erro.

6.3. Lidando com as respostas dos orientadores

Se um orientador revisar seu ramo e pedir a você para mudar algo, você pode fazê-lo facilmente. É só ir ao ramo que você estava trabalhando antes, fazer as alterações solicitadas e então submeter:

$ bzr commit

Agora quando você enviar seu ramo ao Lauchpad, o Bazaar irá lembrar para onde você o enviou, e irá atualizar o ramo no Lauchpad com as suas últimas submissões. Tudo que você precisa fazer é:

$ bzr push

Você pode então responder o e-mail com a proposta de mesclagem, explicando o que você alterou e pedindo uma nova revisão, ou você pode responder na página da proposta de mesclagem no Launchpad.

Note que se você está sendo orientado através de um debdiff anexado a um relatório de erro, você precisará atualizar manualmente gerando um novo diff e anexando-o ao relatório de erro.

6.4. Expectativas

Os desenvolvedores do Ubuntu definiram uma agenda de “pilotos de patch”, que regularmente revisam a fila de orientação e dão resposta para os ramos e patches. Apesar de esta medida ter sido posta em prática, pode ainda levar vários dias até que você obtenha retorno. Isto depende de o quanto todos estão ocupados, se o desenvolvimento está congelado, e outros fatores.

Se ainda não lhe foi dito, sinta-se à vontade para se inscrever em “#ubuntu-devel” ou “irc.freenode.net” e descobrir se alguém por lá pode lhe ajuda.

Para mais informações sobre o processo geral de orientação, reveja a documentação na nossa wiki: https://wiki.ubuntu.com/SponsorshipProcess