Primeiros Passos¶

Primeiro, crie uma conta no GitHub gratuitamente.

Contribuir Online¶

O GitHub facilita muito isso.

Para pequenas alterações em um único arquivo:

Acesse o arquivo que deseja modificar e clique em "Edit".
Faça suas alterações e faça o commit. O GitHub irá guiá-lo e sugerir a abertura de um Pull Request.

Para alterações mais complexas ou em vários arquivos:

Pressione . enquanto navega no repositório ou pull request.
Você será recebido com um "github.dev Web-based Editor" onde poderá trabalhar usando um Visual Studio online.
Faça suas alterações, commit e push como faria localmente.

github.dev
Nota: O texto na imagem permanece em inglês.

Saiba mais sobre o github.dev Web-based Editor na "GitHub Docs".

Por fim, você será solicitado a abrir um Pull Request (PR). Siga as diretrizes de PR ao abrir um PR e obtenha revisão para seu Pull Request.

Contribuir Offline¶

Para isso, você precisa de uma IDE ou editor de texto e git em sua máquina. Recomendamos usar o editor gratuito Visual Studio Code com a extensão markdownlint.

Faça um fork do repositório. Fazer um fork permite que você faça suas alterações sem afetar o projeto original até estar pronto para mesclá-las.

Clone seu repositório forkado e adicione o repositório upstream remoto, por exemplo, para o OWASP MASTG:

$ git clone https://github.com/<seu_usuario_github>/mastg.git
$ cd mastg/
$ git remote add upstream git@github.com:OWASP/mastg.git

Crie uma branch.
```
$ git checkout -b fix-issue-1456
```
Faça suas alterações.
Faça commit e push de suas alterações. Isso pode ser feito executando o comando git add MYFILE para cada arquivo modificado, seguido por git commit -m 'Your Commit Message' para confirmar as modificações e git push para enviar suas modificações para o GitHub.
Abra um PR.
Obtenha revisão para seu PR.