Consertos e entregas
Enviando consertos
Nas primeiras vezes que você realizar alterações no manual, você deverá enviá-las em formato de «patches» (ou enviando o arquivo inteiro, ou um arquivo diferencial) para o administrador da seção para revisão. Isto é feito para garantir que manteremos um manual do usuário com a mais alta qualidade, e que você não quebre acidentalmente qualquer coisa vital antes de estar acostumado com o sistema de trabalho.
De maneira a enviar um conserto, siga este processo:
Faça quaisquer das alterações que desejar.
Crie um arquivo de conserto executando:
svn diff > filename.diff
Isto criará um arquivo de texto simples que mostra quais textos foram adicionados, removidos ou alterados entre seus arquivos de trabalho e o repositório central.
Caso você tenha criado ou apagado arquivos, você deverá executar
svn add /caminho/do/arquivoousvn rm /caminho/do/arquivoantes de criar o arquivo diferencial (diff). Para ver uma lista de arquivos afetados, executesvn status.Após a submissão do arquivo diferencial (diff), você será requisitado a «Criar uma nova revisão», antes que você adicione um título e uma descrição de suas mudanças.
Por favor, verifique se o projeto de documentação está atribuído no campos de tags, de maneira que você possa notificar a equipe responsável sobre seus consertos. Você pode também contactar a equipe através da lista de e-mail ou Bate-papo Blender.
They will review your patch and let you know about any changes you could make. If there is no issue, your patch will be accepted and then committed by the team of your patch.
Nota
Caso os seus consertos incluam alterações para alguns locais ou imagens adicionais, simplesmente anexe-os quando você estiver criando a revisão.
Consertos (patches) necessários e construtivos são propensos a ser aceitos muito rapidamente. Uma vez que você tenha se acostumado a fazer alterações e não necessitar mais de retornos informativos (feedbacks), não haverá mais necessidade de uma pessoa que faça esse intermédio e então, será possível fornecer a você o acesso direto para editar o manual.
Veja também
See Release Cycle for documentation on how to make commits to a specific release branch and how to create merge commits.
Entrega direta
Access to directly submit changes is limited to people with commit access to the SVN repository. Once you are provided with commit access you can start committing directly instead of creating a patch file.
You can make commits from your SVN client or using the SVN command line tool. The following command will create a commit and send it to the central repository:
svn commit -m "This is what I did"
Caso você queira deixar uma mensagem usando -m "mensagem", você será requisitado a digitar a mensagem em um editor de textos.
Dica
You should make sure you are always on the latest revision before committing. You may not be able to commit directly if there are conflicting changes in the latest revision.
To avoid this run svn update before committing.
Veja também
Writing a Good Commit Message
When making changes to the manual that directly relate to a specific commit (change) in Blender, it is helpful to make the title of the commit the same as the commit made to Blender. It is requested that you include the commit hash of the commit made to the Blender source code.
For example, the commit rBM8473
includes a descriptive indicative of the changes made along with the hash rBa71d2b260170.
The hash can be extracted from the URL provided in the Documentation task for a specific upcoming release.
Other more general changes do not have to follow the above policy however,
it is still important to make the description clear about what changes you made and why.
It can be helpful to prefix the commit title with a prefix word such as Cleanup: or Fix:
when you are making general cleanups or fixes respectively.
Writing good commit messages helps administrators keep track of changes made and ensures all new features are properly documented.