Organização do projeto Sphinx¶
O guia explica como o projeto Sphinx está organizado.
Desenvolvedores core¶
Os desenvolvedores core do Sphinx possuem direito de escrita no repositório central. Podem fazer commit das modificações, aceitar / rejeitar pull requests bem como gerenciar itens no rastreador.
Diretrizes¶
As seguintes diretrizes são orientações para desenvolvedores core:
Extensivas ou modificações questionáveis devem ser submetidas como pull requests ao invés de commit direto no repositório principal. A pull request deve ser revista por outro desenvolvedor core antes de ser mesclada.
Modificações triviais podem ser incorporadas diretamente mas certificar-se que o repositório esteja em situação funcional e que todos os testes passaram antes de finalizar modificações.
Ao fazer commit do código escrito por outra pessoa, favor identificar o autor na mensagem de commit e quaisquer outras entradas de
CHANGES.rst
.
Associação¶
Core membership is predicated on continued active contribution to the project. In general, prospective cores should demonstrate:
a good understanding of one of more components of Sphinx
a history of helpful, constructive contributions
a willingness to invest time improving Sphinx
Refer to Contribuindo para o Sphinx for more information on how you can get started.
Outros contribuidores¶
Não é preciso ser um desenvolvedor do núcleo ou possuir acesso a gravação para fazer algum desenvolvimento no Sphinx. As modificações podem ser submetidas através de requisições pull a partir de repositórios derivados e então um desenvolvedor do núcleo fará suas modificações.
Similarly, contributions are not limited to code patches. We also welcome help triaging bugs, input on design decisions, reviews of existing patches and documentation improvements. More information can be found in Contribuindo para o Sphinx.
A list of people that have contributed to Sphinx can be found in Autores do Sphinx.