Cuidado com o fluxo de trabalho, para evitar retrabalho!

[Luciano Ramalho]

Pessoal, outro dia eu retirei do apêndice A duas ocorrências da
marcação :math: uma vez que essa extensão não vem configurada por
default no Sphinx.

Só que estas marcações voltaram, o que significa que alguém editou o
apêndice sem levar em conta as alterações que eu fiz.

Não podemos deixar este tipo de problema acontecer no nosso fluxo de
trabalho, senão estaremos continuamente desfazendo os trabalhos uns
dos outros.

É fundamental que qualquer um que edite o texto faça o seguinte:

1) antes de começar o trabalho, você precisa fazer um pull do
repositório central;

2) se você trabalhou em paralelo com alguém, o pull vai gerar dois
heads, ou seja, duas versões divergentes; neste caso você pode dar o
comando hg heads para ver dados das versões, e daí precisa dar hg
merge para juntar, e hg commit para salvar o resultado do merge;

3) feito o merge e o commit, você precisa dar um push para o seu
repositório e mandar um pull request para mim, de modo que eu
incorpore o que você fez no repositório central

Provavelmente o que aconteceu é que alguém esqueceu de fazer os passos
1 ou 2 acima, então a alteração que eu havia feito no apêncide se
perdeu.

Neste caso, não era quase nada, foi tranquilo refazer a alteração, e
foi fácil localizar porque o Sphinx gerou um warning. Mas a grande
maioria das alterações que a gente está fazendo não são na marcação, e
sim no texto, e aí não tem aviso nenhum, de modo que fica muito fácil
jogar fora o trabalho dos outros se a gente não entender bem como deve
ser feito o processso, e tomar cuidado.

[ ]s
Luciano