Edição do manual

Atualizações

Primeiramente, tenha certeza de que sua cópia local do manual esteja atualizada em relação ao repositório online usando:

svn update

Escrevendo

Agora você pode fazer edições nos arquivos de documentação, os quais são arquivos do tipo .rst dentro da pasta manual usando um editor de textos de sua escolha.

Certifique-se de checar /about/contribute/style_guides/writing_guide para as convenções e /about/contribute/style_guides/markup_guide para aprender como escrever na linguagem de marcações «reStructuredText» (RST).

Feliz escrita !

Grandes alterações

Caso você esteja pretendendo adicionar ou reformar uma seção, tenha certeza de verificar cuidadosamente se essa documentação já é existente. Em alguns lugares, os documentos são tão desorganizados que as seções podem estar duplicadas ou em uma localização estranha. No caso de você encontrar uma duplicação ou seção fora de seu local, crie uma tarefa , explicando o problema, e opcionalmente inclua uma revisão (com as alterações atuais).

Antes de fazer quaisquer edições que não são simples e plenamente justificáveis, (por exemplo, como mover pastas), você deverá certificar-se com algum dos mantenedores do manual que a sua contribuição está alinhada com a visão comunitária do manual. Isto assegura a melhor utilização de seu tempo e boa vontade mesmo que seja possível que, por alguma razão, as suas alterações sejam conflitantes e possam ser rejeitadas ou necessitem de uma revisão que consuma uma grande quantidade de tempo. Por exemplo, outra pessoa poderia já estar trabalhando na seção que você deseja alterar, a seção pode estar agendada para ser apagada ou ser atualizada de acordo com um planejamento de alteração no Blender.

A Comunicação rápida e frequente é a chave para obtenção de um ambiente produtivo, para que não sejam desperdiçados esforços de pessoas e para que possamos chegar a um melhor manual do Blender como resultado.

Obtendo ajuda e respostas

Caso você ainda esteja em dúvidas sobre uma funcionalidade que deseja documentar, você deve enviar as suas questões para os desenvolvedores Blender responsáveis por esta área ou perguntar no canal de suporte IRC. não oficial em #blender.

O Blender possui um sistema de proprietários de módulos com membros desenvolvedores e artistas que são responsáveis pelo projeto e manutenção das áreas do Blender que lhes são atribuídas. Veja a página de proprietários de módulos para mais informações.

Pré-visualização

Para verificar as suas alterações, construa o manual como instruído aqui

Envio de arquivos

Quando você estiver satisfeito com as suas alterações, você poderá enviá-las (fazendo seu upload), de maneira que elas estejam no manual online. Inicialmente, isto é feito através da submissão de consertos (patches) de maneira que alguém possa revisar as suas alterações e fornecer a você informações de retorno. Após esta etapa, você poderá entregar suas alterações diretamente. este processo está descrito em detalhes na próxima seção.