Informação sobre como enviar patches para serem analisados

Editar esta página -- Voltar à página anterior

EnglishpolskiPortuguês

Descarregue o website do Transit do repositório Git, usando o seguinte comando:

git clone https://notabug.org/transit/transit-website.git

Git é um sistema de controlo de versões, utilizado para hospedar o site com o fim de coordenar o desenvolvimento do mesmo. Pode descarregar e trabalhar no website inteiro, usando Git.

O Software Git está disponível em Windows, MacOS, Gnu+Linux, BSD e noutras plataformas. Nós recomendamos vivamente que utilize Gnu+Linux ou BDS, mas Windows ou MacOS também funcionam. Procure no Google informação básica sobre como usar o Git.

Algumas das instruções nesta página assumem que você usa Gun-Linux ou BSD, por isso você irá ter que adaptar de acordo, se usar outro sistema. Todxs xs administradorxs que mantêm o website usam Gnu+Linx.

Você pode submeter os seus patches através de pull requests no Notabug ou ao

Editar o website e documentação, tal como se tratasse de um wiki

O website e respetiva documentação encontram-se dentro do diretório www no repositório Git, escrito em Pandoc com certos aspetos de Markdown. O website é gerado em HTML estático através de Pandoc com os seguintes scripts em cada diretório:

Use qualquer editor de texto (por exemplo Vim, Emacs, Nano, Gedit) para editar os ficheiros, fazer commits e enviar patches.

Como alternativa, pode instalar um web server (por exemplo lighttpd, nginx) localmente e definir o documento root como o diretório www no seu repositório Git local. Com esta configuração, você pode gerar a sua versão local do website e vê-la ao escrever localhost na barra de URL do seu browser.

Privacidade dxs contribuidorxs (você não tem que revelar o seu nome ou identidade!)

As contribuições que você faz são registadas publicamente, num repositório Git ao qual toda a gente tem acesso. Isto inclui o nome e endereço da pessoa que contribui.

Você não necessita de usar informação sobre si no Git, como o seu nome e endereço de email. Você pode usar o nome “Transit Contributor” e o seu email pode ser “contributor@transit.org.uk”. Você é permitidx a fazê-lo se desejar manter a sua privacidade.

Obviamente que você pode escolher qualquer nome que você queira.

Em termos legais. qualquer copyright é automaticamente aplicado segundo a Convenção da União de Berna, independentemente do nome que você usar ou mesmo independentemente de você declarar copyright ou não (embora nós pedimos que certas licenças sejam utilizadas - leia mais sobre este assunto mais à frente nesta página).

Se você utilizar um nome e um endereço de email diferentes em cada commit/patch que você fizer, então você deverá manter-se suficientemente anónimx.

Diretrizes gerais para submeter patches

Nós pedimos que todos os patches sejam submetidos isentos de copyright> https://www.gnu.org/licenses/license-list.html.

Declare sempre uma licença no seu trabalho! Ao não declarar uma licença isso significa que as leis de copyright padrão serão aplicadas, que são restritivas, o que significa que o seu trabalho não será isento de copyright.

Diretrizes para verificação de código programático

Qualquer membro do público pode submeter um patch.

O seu patch irá ser analisado para garantir a sua qualidade e integrado se for aceite.

Como fazer download do Transit a partir do repositório Git

No seu terminal:

git clone https://notabug.org/transit/transit-website.git

Um diretório chamado transit será criado com o Transit dentro dele.

Como submeter os seus patches (via pull requests)

Faça uma conta em https://notabug.org/ e vá à seguinte página (depois de ter feito log in) https://notabug.org/transit/transit-website. Clique Fork e você irá receber um repositório do Transit na sua conta. Faça uma cópia do seu repositório, faça as alterações que tem a fazer e depois introduza essas alterações ao seu repositório, na sua conta NotABug.

Vá à página https://notabug.org/transit/transit-website/pulls e clique em Novo Pull Request.

Você pode submeter os seus patches nesta página. Alternativamente, você pode fazer login ao canal de IRC do Transit e chamar a atenção dos utilizadores presentes para patches que você quer que sejam analisados.

Assim que você tenha feito um Pull Request, xs responsáveis pelo bom funcionamento do Transit irão ser notificadxs via email. Se você não receber uma resposta suficientemente rápida a partir do projecto, então você pode notificar o projecto através do canal ##transit no Freenode.


Editar esta páginaLicençaModelo licençaContribuirDiretrizes de Conduta

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License Version 1.3 or any later version published by the Free Software Foundation with no Invariant Sections, no Front Cover Texts, and no Back Cover Texts. A copy of this license is found in /fdl-1.3.html

Para informação sobre quem possui copyright sobre o conteúdo de cada página e em que ano, refira-se ao repositório Git, no qual o website está hospedado, e verifique a lista de commits.