├── LICENSE ├── README.md ├── como-participar.md ├── contribuindo.md ├── imagens ├── abrindo-pr.png ├── botao-fork.png ├── botao-start-hacking.png ├── busca-tag-hacktoberfest.png ├── commit-perfil-hacktober.png ├── comparando.png ├── create-pull-request.png ├── forking.png ├── gitwin.jpeg ├── good-first.png ├── login.png ├── logo.png ├── perfil.png ├── projects.png ├── pull-request.png ├── remoto-modificado.png ├── repo-fork.png ├── repositorio-local-participantes.png ├── repositorio-local.png ├── repositorio.png └── site.png ├── participantes ├── .keep ├── Alexandre Gomes.txt ├── Bruna Seewald.txt ├── Bruno Liberal.txt ├── Cairo Noleto.txt ├── Cássio Botaro.txt ├── Denis Oliveira.txt ├── Fabiano Romano.txt ├── Felipe.txt ├── FernandoPimenta.txt ├── Fossali ├── Isabella Ferreira.txt ├── João Garcia.txt ├── João Guilherme.txt ├── Lorena Leao.txt ├── Machado.txt ├── Michael Welsch.txt ├── NianGomes.txt ├── Reginaldo Lima.txt ├── Tiago Guimaraes.txt ├── VictorFrança.txt └── miltonsasaki.txt ├── procurando.md ├── ramificacao.md └── vocabulario.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2019 Python Minas Gerais 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |

2 | Logo hacktoberfest 3 |

4 | 5 | # Hacktoberfest 6 | 7 | :octocat: Apoie o open source e ganhe uma camisa exclusiva! :octocat: 8 | 9 | Este guia foi criado pensando em ajudar a realizar as primeiras contribuições open source, em forma de um passo a passo a ser seguido. 10 | 11 | Para facilitar a compreensão do guia, fizemos um [vocabulário](vocabulario.md) com algumas palavras que podem ser desconhecidas. 12 | 13 | ## Passo a passo 14 | 15 | :tshirt: [Como Participar?](como-participar.md) 16 | 17 | :package: [Nossa primeira contribuição.](contribuindo.md) 18 | 19 | :mag: [Procurando mais projetos para contribuir!](procurando.md) 20 | -------------------------------------------------------------------------------- /como-participar.md: -------------------------------------------------------------------------------- 1 | # :tshirt: Como participar? 2 | 3 | Entre em [https://hacktoberfest.digitalocean.com](https://hacktoberfest.digitalocean.com). 4 | 5 | ![site](imagens/site.png "site hacktoberfest") 6 | 7 | Clique no botão de "Start Hacking" para cadastrar seu perfil do github. 8 | 9 | ![botão start hacking](imagens/botao-start-hacking.png "botão start hacking") 10 | 11 | Será pedido que você autorize o [Github](https://github.com/) a monitorar sua conta, assim ele conseguirá contabilizar suas pull requests. 12 | 13 | Não se preocupe que as permissões não envolvem publicações em seu nome ou monitoramento de projetos privados. 14 | 15 | ![autorização github](imagens/login.png "login github") 16 | 17 | Assim que digitar seu usuário e senha do github você será redirecionado para seu perfil onde pode acompanhar seu progresso. 18 | 19 | ![perfil hacktoberfest](imagens/perfil.png "perfil hacktoberfest") 20 | 21 | :tada: Parabens! Agora vamos começar a contribuir! 22 | 23 | [Nossa primeira contribuição :arrow_right:](contribuindo.md) 24 | 25 | [:leftwards_arrow_with_hook: Voltar ao README ](README.md) 26 | -------------------------------------------------------------------------------- /contribuindo.md: -------------------------------------------------------------------------------- 1 | # :package: Nossa primeira contribuição. 2 | 3 | Serão necessárias 4 contribuições para ganhar uma camisa exclusiva, nós vamos te ajudar a realizar uma delas te ensinando a como contribuir com projetos open source e ao mesmo tempo você irá contribuir com pessoas procurando projetos para contribuir. 4 | 5 | Esperamos que isto sirva de incentivo para continuar contribuindo mesmo depois de já ter ganho a camisa. 6 | 7 | O primeiro passo é instalação da ferramenta `git`. 8 | 9 | Siga os passos de acordo com o seu sistema operacional e tenha certeza de que a ferramenta está instalada e funcionando antes de prosseguir. 10 | 11 | ### :octocat: Git 12 | 13 | **O que é?** 14 | 15 | [Git](https://git-scm.com/) é um controle de versão livre e de código aberto, construido para lidar com projetos pequenos e grandes de maneira rápida e eficiente. 16 | 17 | **Para que serve?** 18 | 19 | Com certeza você já escreveu um arquivo, mais tarde troca algumas coisas e salva como final. Mais tarde ou no outro dia você decide fazer mais mudanças e chama de "agoravai" e quando menos percebe já tem um monte de arquivos e talvez nem se lembre mais qual a última versão. 20 | 21 | É para gerenciar alterações feitas no projeto durante o tempo que serve esta ferramenta. 22 | 23 | Durante o guia vamos salvando as alterações feitas sem precisar de ter várias cópias do mesmo arquivo. 24 | 25 | **Como instalar** 26 | 27 | :computer: *windows* 28 | 29 | Para usuários windows, baixe a última versão neste [site](https://git-scm.com://git-scm.com/). Deixe as opções já marcadas por padrão, exceto a mostrada abaixo que deve ser ajustada. 30 | 31 | ![opção path](imagens/gitwin.jpeg "opção path no instalador") 32 | 33 | :package: *ubuntu* 34 | 35 | O pacote git se encontra na central de programas. 36 | 37 | `sudo apt install git` 38 | 39 | **Vamos verificar se deu tudo certo?** 40 | 41 | :computer: *windows* 42 | 43 | Clique no botão iniciar, digite `cmd` e abra o programa `prompt de comandos`. Agora digite `git --version`. 44 | 45 | :package: *ubuntu* 46 | 47 | Abra um terminal e digite `git --version`. 48 | 49 | A saída para ambos os sistemas operacionais deverá ser: 50 | 51 | ```bash 52 | $ git --version 53 | git version 2.19.0 54 | ``` 55 | 56 | ## Criando uma cópia do repositório 57 | 58 | Com as ferramentas prontas, vamos contribuir com o primeiro projeto. 59 | 60 | Mas como escolher um projeto? Como saber como eu devo proceder e quais as exigências do projeto? 61 | 62 | Guarde estas dúvidas, pois serão respondidas até o final, por enquanto, para aprender os passos de como contribuir, vamos iniciar contribuindo com este guia. 63 | 64 | Já estamos com o repositório aberto e estamos vendo os arquivos e diretórios contidos nele. 65 | 66 | Vamos começar fazendo um "*fork*" do repositório original. 67 | 68 | Isto é necessário pois normalmente não temos permissões de alteração do repositório ao qual estamos contribuindo. 69 | 70 | Abra em uma outra aba o [repositório](http://github.com/pythonmg/hacktoberfest). 71 | 72 | ![repositório](imagens/repositorio.png "repositório") 73 | 74 | Clique no botão "fork" que aparece no canto superior direito. 75 | 76 | ![botão fork](imagens/botao-fork.png "botão fork") 77 | 78 | Aguarde enquanto a cópia será feita. 79 | 80 | ![bifurcando código](imagens/forking.png "bifurcando código") 81 | 82 | Quando terminar você será redirecionado para a cópia do repositório que agora está na sua conta. 83 | 84 | ![repo fork](imagens/repo-fork.png "repo fork") 85 | 86 | Repare que abaixo do nome do repositório ele indica que aquele repositório é um "*fork*" de outro. 87 | 88 | ## Modificando os arquivos 89 | 90 | Agora temos uma cópia nosso do projeto original, vamos modificá-la, acrescentando nosso nome na lista de participantes da hacktoberfest. 91 | 92 | A nossa cópia está apenas em nossa conta do github, precisamos trazê-la para nosso computador. 93 | 94 | Vamos fazer um "*clone*" do nosso repositório. 95 | 96 | :warning: Não esqueça de substituir `` pelo seu nome de usuário no github 97 | 98 | :computer: *windows* 99 | 100 | Clique no botão iniciar, digite `cmd` e abra o programa `prompt de comandos`. 101 | 102 | Navegue até o diretório que deseja trabalhar por exemplo `C:\Usuários\Cassio`. 103 | 104 | :point_right: Uma dica, para navegar entre diretórios utilize o comando `cd`. 105 | 106 | Agora digite `git clone https://github.com//hacktoberfest.git`. 107 | 108 | :package: *ubuntu* 109 | 110 | ```bash 111 | $ cd ~ 112 | $ git clone https://github.com//hacktoberfest.git 113 | Cloning into 'hacktoberfest'... 114 | remote: Enumerating objects: 14, done. 115 | remote: Counting objects: 100% (14/14), done. 116 | remote: Compressing objects: 100% (14/14), done. 117 | remote: Total 14 (delta 1), reused 8 (delta 0), pack-reused 0 118 | Unpacking objects: 100% (14/14), done. 119 | ``` 120 | 121 | Agora vamos até o diretório onde está, mas não feche a tela preta, pois já voltamos pra ela. 122 | 123 | ![repositório local](imagens/repositorio-local.png "repositório local") 124 | 125 | Crie um novo arquivo com seu nome e sobrenome no diretório `participantes`. 126 | 127 | Exemplo: Cássio Botaro.txt 128 | 129 | O conteúdo deste arquivo será seu usuário do github e o ano que participou. 130 | 131 | Exemplo: 132 | ``` 133 | usuário: cassiobotaro 134 | ano: 2019 135 | ``` 136 | 137 | ![participantes](imagens/repositorio-local-participantes.png "participantes") 138 | 139 | Terminamos de modificar o projeto, vamos agora salvar as alterações feitas. 140 | 141 | 142 | ## Salvando as alterações feitas 143 | 144 | Com o nosso nome já entre os participantes vamos salvar as alterações que fizemos e enviar de volta para o servidor (github). 145 | 146 | De volta a tela preta, vamos utilizar o comando `git status` para checar o que foi feito até agora. 147 | 148 | ```bash 149 | $ git status 150 | On branch master 151 | Your branch is up-to-date with 'origin/master'. 152 | 153 | Untracked files: 154 | (use "git add ..." to include in what will be committed) 155 | 156 | participantes/Cássio Botaro.txt 157 | 158 | nothing added to commit but untracked files present (use "git add" to track) 159 | ``` 160 | 161 | Vemos que nosso arquivo criado não está rastreado, precisamos então avisar ao controle de versão (git) que monitore este arquivo. 162 | 163 | `$ git add participantes/Cássio \Botaro.txt` 164 | 165 | :floppy_disk: Agora vamos marcar esta versão como salva. Se estivessemos em um jogo de video game é como se estivessemos salvando nosso progresso no jogo. 166 | 167 | `git commit -m "adicionando novo participante"` 168 | 169 | :up: Por fim, envie ao github a versão atualizada do projeto. 170 | 171 | `git push` 172 | 173 | ![repositório github modificado](imagens/remoto-modificado.png) 174 | 175 | ## Pedindo a junção dos códigos 176 | 177 | Agora é a hora de pedirmos ao repositório que estamos contribuindo a junção das nossas alterações ao repositório original. 178 | 179 | Clique no botão "*pull request*". 180 | 181 | ![botão pull request](imagens/pull-request.png) 182 | 183 | Uma página comparando suas alterações com o repositório original será aberta. 184 | 185 | ![Comparando as alterações](imagens/comparando.png) 186 | 187 | Clique no botão verde "*Create pull request*". 188 | 189 | Na Nova tela que irá se abrir, coloque um título das modificações que foram feitas. 190 | 191 | ![Abrindo pull request](imagens/abrindo-pr.png) 192 | 193 | E uma descrição detalhada. Será necessário apertar mais uma vez no botão verde para concluir o processo. 194 | 195 | ![Criando uma pull request](imagens/create-pull-request.png) 196 | 197 | ## Parabéns 198 | 199 | Meus parabéns! Você realizou sua primeira contribuição em algum projeto open source. 200 | 201 | Volte na sua página de [perfil da hacktoberfest](https://hacktoberfest.digitalocean.com/profile) e veja que sua barra de progresso aumentou. 202 | 203 | ![commit contabilizado na hacktoberfest](imagens/commit-perfil-hacktober.png) 204 | 205 | Espero que seja a primeira de muitas. 206 | 207 | Vamos agora explorar todo o mundo do open source! 208 | 209 | [Procurando mais projetos para contribuir! :arrow_right:](procurando.md) 210 | 211 | [:arrow_left: Como participar?](como-participar.md) 212 | 213 | [:leftwards_arrow_with_hook: Voltar ao README ](README.md) 214 | -------------------------------------------------------------------------------- /imagens/abrindo-pr.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/abrindo-pr.png -------------------------------------------------------------------------------- /imagens/botao-fork.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/botao-fork.png -------------------------------------------------------------------------------- /imagens/botao-start-hacking.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/botao-start-hacking.png -------------------------------------------------------------------------------- /imagens/busca-tag-hacktoberfest.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/busca-tag-hacktoberfest.png -------------------------------------------------------------------------------- /imagens/commit-perfil-hacktober.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/commit-perfil-hacktober.png -------------------------------------------------------------------------------- /imagens/comparando.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/comparando.png -------------------------------------------------------------------------------- /imagens/create-pull-request.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/create-pull-request.png -------------------------------------------------------------------------------- /imagens/forking.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/forking.png -------------------------------------------------------------------------------- /imagens/gitwin.jpeg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/gitwin.jpeg -------------------------------------------------------------------------------- /imagens/good-first.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/good-first.png -------------------------------------------------------------------------------- /imagens/login.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/login.png -------------------------------------------------------------------------------- /imagens/logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/logo.png -------------------------------------------------------------------------------- /imagens/perfil.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/perfil.png -------------------------------------------------------------------------------- /imagens/projects.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/projects.png -------------------------------------------------------------------------------- /imagens/pull-request.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/pull-request.png -------------------------------------------------------------------------------- /imagens/remoto-modificado.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/remoto-modificado.png -------------------------------------------------------------------------------- /imagens/repo-fork.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/repo-fork.png -------------------------------------------------------------------------------- /imagens/repositorio-local-participantes.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/repositorio-local-participantes.png -------------------------------------------------------------------------------- /imagens/repositorio-local.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/repositorio-local.png -------------------------------------------------------------------------------- /imagens/repositorio.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/repositorio.png -------------------------------------------------------------------------------- /imagens/site.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/imagens/site.png -------------------------------------------------------------------------------- /participantes/.keep: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/participantes/.keep -------------------------------------------------------------------------------- /participantes/Alexandre Gomes.txt: -------------------------------------------------------------------------------- 1 | usuário: xandmaga 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Bruna Seewald.txt: -------------------------------------------------------------------------------- 1 | usuário: bseewald 2 | ano: 2019 -------------------------------------------------------------------------------- /participantes/Bruno Liberal.txt: -------------------------------------------------------------------------------- 1 | usuário: brunoliberal 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Cairo Noleto.txt: -------------------------------------------------------------------------------- 1 | usuario: caironoleto 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Cássio Botaro.txt: -------------------------------------------------------------------------------- 1 | usuario: cassiobotaro 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Denis Oliveira.txt: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/participantes/Denis Oliveira.txt -------------------------------------------------------------------------------- /participantes/Fabiano Romano.txt: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/participantes/Fabiano Romano.txt -------------------------------------------------------------------------------- /participantes/Felipe.txt: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pythonmg/hacktoberfest/f1c8b5272db0ae0018c0a40905493a1c18d1da60/participantes/Felipe.txt -------------------------------------------------------------------------------- /participantes/FernandoPimenta.txt: -------------------------------------------------------------------------------- 1 | usuário: fcpimenta 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Fossali: -------------------------------------------------------------------------------- 1 | usuário: Fossali 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Isabella Ferreira.txt: -------------------------------------------------------------------------------- 1 | usuario: isabellaf 2 | ano: 2019 -------------------------------------------------------------------------------- /participantes/João Garcia.txt: -------------------------------------------------------------------------------- 1 | usuario: joaogarciadelima 2 | ano: 2019 -------------------------------------------------------------------------------- /participantes/João Guilherme.txt: -------------------------------------------------------------------------------- 1 | usuário: joao-guilherme 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Lorena Leao.txt: -------------------------------------------------------------------------------- 1 | usuario: lorenaleao 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Machado.txt: -------------------------------------------------------------------------------- 1 | usuário: machadowisck 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Michael Welsch.txt: -------------------------------------------------------------------------------- 1 | usuário: michael080584 2 | ano: 2019 -------------------------------------------------------------------------------- /participantes/NianGomes.txt: -------------------------------------------------------------------------------- 1 | usuário: niangomes 2 | ano: 2019 -------------------------------------------------------------------------------- /participantes/Reginaldo Lima.txt: -------------------------------------------------------------------------------- 1 | usuario: donvitonet 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/Tiago Guimaraes.txt: -------------------------------------------------------------------------------- 1 | usuario: tilacog 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/VictorFrança.txt: -------------------------------------------------------------------------------- 1 | usuario: victorfrança 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /participantes/miltonsasaki.txt: -------------------------------------------------------------------------------- 1 | user: msasaki 2 | ano: 2019 3 | -------------------------------------------------------------------------------- /procurando.md: -------------------------------------------------------------------------------- 1 | # :mag: Procurando mais projetos para contribuir! 2 | 3 | :scream: E agora, como vou achar mais projetos para contribuir? 4 | 5 | O site oficial da hacktoberfest possui uma [lista](https://hacktoberfest.digitalocean.com/#projects) com alguns projetos precisando de ajuda. 6 | 7 | ![Projetos](imagens/projects.png) 8 | 9 | Fazendo uma [pesquisa](https://github.com/search?q=is%3Aopen+is%3Aissue+label%3AHacktoberfest+language%3Apython&state=open&type=Issues) no github, com a tag #hacktoberfest você também vai encontrar vários projetos legais. 10 | 11 | ![busca github](imagens/busca-tag-hacktoberfest.png) 12 | 13 | Agora com ajuda dos mentores, vá nessas lista e procure mais projetos que você pode contribuir. 14 | 15 | Caso esteja acompanhando este guia posteriormente, sinta-se a vontade para pedir ajuda através do nosso canal do telegram, @pythonmg. 16 | 17 | :pushpin: Normalmente os problemas mais fáceis de resolver possuem a tag `good first issue`. 18 | 19 | ![good first issue](imagens/good-first.png) 20 | 21 | Uma outra opção é ajudar a aprimorar este guia, temos algumas ["*issues*"](https://github.com/pythonmg/hacktoberfest/issues) que estão em aberto. 22 | 23 | Minha dica é: Procure projetos que te pareçam legal, fique de olho nas "*issues*" e nas "*pull requests*" do projeto. Uma contribuição de documentação tem tanta importância quanto uma funcionalidade nova. Veja como as pessoas resolvem os problemas que aparecem, utilize o projeto e se algo der errado, não deixe de reportar. 24 | 25 | Outra dica é sempre ficar atento aos guias de como contribuir que alguns projetos possuem. Normalmente eles dizem como deve ser o estilo do código daquele projeto, ou validações necessárias antes de seu código seja mesclado. 26 | 27 | Não se sinta intimidado quando outra pessoa revisar seu "*pull request*" e pedir alguma alteração, pelo contrário, encare isto como aprendizado. 28 | 29 | :checkered_flag: É isto pessoal! Keep Hacking! 30 | 31 | [:arrow_left: Nossa primeira contribuição](contribuindo.md) 32 | 33 | [:leftwards_arrow_with_hook: Voltar ao README ](README.md) 34 | -------------------------------------------------------------------------------- /ramificacao.md: -------------------------------------------------------------------------------- 1 | 2 | # Contribuindo de maneira profissional através do uso de ramificações 3 | 4 | Agora que você já sabe como realizar uma contribuição de maneira simples, vamos aprender como fazer uma contribuição da maneira que os projetos open source geralmente recomendam. 5 | 6 | Não vamos repetir tudo novamente, mas apenas acrescentar algumas tarefas intermediárias no processo. 7 | 8 | Suponha que você fosse seguir o passo a passo novamente: 9 | 10 | :package: [Nossa primeira contribuição.](contribuindo.md) 11 | 12 | Você vai fazer o **fork** normalmente. 13 | 14 | Você também vai **clonar** o repositório da mesma maneira. 15 | 16 | Aqui é que as coisas se modificam um pouco. 17 | 18 | Quando você trabalha em um projeto colaborativo, você e outros desenvolvedores que estão contribuindo no repositório terão ideias diferentes para novas funcionalidades ou correções ao mesmo tempo. Algumas dessas novas funcionalidades não levarão muito tempo para serem implementadas, mas outras delas poderão demorar. Por isso, é importante ramificar o repositório para que você consiga gerenciar o fluxo de trabalho, isolar seu código e controlar quais funcionalidades de fato serão colocadas na ramificação master do repositório. 19 | 20 | Por padrão a ramificação principal do repositório do projeto é normalmente chamada de master branch. Uma boa prática comum é considerar tudo que está na master branch pronta para uso/deploy a qualquer tempo. 21 | 22 | Então vamos lá. 23 | 24 | ## Crie uma nova ramificação 25 | 26 | Entre no repositório e crie uma nova ramificação para trabalhar: 27 | 28 | `git branch nova-ramificacao` 29 | 30 | Mude para a nova ramificação: 31 | 32 | `git checkout nova-ramificacao` 33 | 34 | Se você quiser retornar à ramificação master local, basta digitar: 35 | 36 | `git checkout master` 37 | 38 | Agora faça as alterações localmente. Depois de fazer, adicione as mudanças da mesma forma que você fez no primeiro tutorial: 39 | 40 | `git add -A` 41 | 42 | Da mesma forma, confirme as alterações no repositório: 43 | 44 | `git commit -m "Adicionada documentação sobre ramificações"` 45 | 46 | Verifique se não há mais nada para alterar: 47 | 48 | `git status` 49 | 50 | Nesse ponto você pode usar o comando `git push` para enviar as alterações para a ramificação atual do repositório que você fez fork. 51 | 52 | `git push --set-upstream origin nova-ramificacao` 53 | 54 | ## Criando um Remote para o repositório que você fez fork. 55 | 56 | Para poder sincronizar as mudanças que você fez em um fork com o repositório original que você está trabalhando, você precisa configurar um remote que referencia o repositório upstream. Isso é feito apenas uma vez. 57 | 58 | Verifique os remotos atuais: 59 | 60 | `git remote -v` 61 | 62 | Nesse caso vão aparecer apenas os remotos do repositório que você fez fork. 63 | 64 | Agora adicione o repositório original como upstream: 65 | 66 | `git remote add upstream https://github.com/nomeusuario-dono-original/repositorio-original.git` 67 | 68 | Verifique que agora você tem o upstream, representando o repositório remoto original: 69 | 70 | `git remote -v` 71 | 72 | ## Sincronize o seu fork com o repositório oficial: 73 | 74 | `git fetch upstream` 75 | 76 | Agora, os commits na ramificação master serão armazenados em uma ramificação local chamada upstream/master. 77 | 78 | Vamos para a master então: 79 | 80 | `git checkout master` 81 | 82 | Agora vamos fazer a mesclagem ou **merge** de quaisquer mudanças feitas na ramificação master do repositório original, as quais poderemos acessar através de nossa ramificação upstream/master: 83 | 84 | `git merge upstream/master` 85 | 86 | Finalmente, crie o pull request para solicitar o merge da ramificação master do repositório original e a sua ramificação nova-ramificacao. O pull request em si você já sabe fazer, como no primeiro tutorial. 87 | 88 | **Obs:** Esse pull request foi feito usando essa prática. 89 | -------------------------------------------------------------------------------- /vocabulario.md: -------------------------------------------------------------------------------- 1 | # :bookmark_tabs: Vocabulário 2 | 3 | Para te ajudar a não se perder nos termos técnicos utilizados, listamos algumas palavras mais comuns. 4 | 5 | ## clone 6 | 7 | Comando git para criar uma cópia dos arquivos e suas versões. Pode ser feito para trazer uma cópia do repositório do servidor para o computador local. 8 | 9 | ## commit 10 | 11 | É o conjunto de mudanças que fizemos no código. Pode ser relacionado com o save point em um jogo. 12 | 13 | ## diretório 14 | 15 | Ou pasta, é uma estrutura utilizada para organizar arquivos em um computador ou um arquivo que contém referências a outros arquivos. 16 | 17 | ## fork 18 | 19 | Pode ser traduzido como "bifurcação", e no nosso contexto é quando fazemos uma cópia do repositório original. Esse novo repositório é independente do original. 20 | 21 | ## hacktoberfest 22 | 23 | Evento que ocorre todos os anos para apoiar a contribuição em projetos open source. Algumas empresas se juntam e parabenizam com uma camisa exclusiva a quem contribui. 24 | 25 | ## issues 26 | 27 | São ideias, melhorias, tarefas ou bugs para se trabalhar no Github. 28 | 29 | ## pull request 30 | 31 | Também conhecido como "merge request", é quando você faz uma mudança em um código(de terceiros) e pede a autorização dos responsáveis pelo projeto para fazer a junção da sua mudança com a versão atual do mesmo. 32 | 33 | ## repositório 34 | 35 | Pasta principal do projeto contendo os arquivos relevantes do projeto incluindo documentações, código e um histórico das revisões para cada arquivo. 36 | 37 | 38 | [:leftwards_arrow_with_hook: Voltar ao README ](README.md) 39 | --------------------------------------------------------------------------------