You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Esse é um tutorial para ajudar os contribuidores inicial a participar de um simples e fácil projeto.
Objetivos
Fazer uma contribuição para um projeto Open Source.
Ficar mais confortável usando o GitHub.
Para quem é isso?
Isto é para iniciantes absolutos. Se você sabe como escrever e editar uma tag de âncora <a href="" target=""> </a>, deve poder fazer isso.
Isto é para aqueles com um pouco mais de experiência mas que querem fazer a sua primeira contribuição para um Open Source, ou possuir mais contribuições para maior experiência e confiança.
Por que eu preciso fazer isso?
Qualquer desenvolvedor web, aspirante ou experiente, precisa usar o controle de versão do Git, e o GitHub é o serviço de hospedagem Git mais popular usado por todos. É também o coração da comunidade Open Source. Ficar confortável com o GitHub é uma habilidade essencial. Fazer uma contribuição para um projeto aumenta sua confiança e oferece a você algo para mostrar no seu perfil do GitHub.
Se você é um novo desenvolvedor e está se perguntando se precisa aprender Git e GitHub, aqui está a resposta: Você deveria ter aprendido Git ontem.
Com o que vou contribuir?
Você contribuirá com um cartão como este para esta página de projetos. Ele incluirá seu nome, seu endereço no Twitter, uma breve descrição e três links para recursos úteis para os desenvolvedores da web que você recomenda.
Você fará uma cópia do modelo do cartão dentro do arquivo HTML e o personalizará com suas próprias informações.
Faça o login na sua conta do GitHub. Se você ainda não tem uma conta então entre no GitHub. Eu recomendo que você faça o GitHub Hello World tutorial antes de você continuar.
Como alternativa, se você estiver confortável usando o Git na linha de comando, faça isso (aqui está primeiras contribuições, um projeto semelhante que pode servir como um guia para os comandos necessários). OU
Se você usa VS Code ele vem com o Git integrado e permite que você faça o que precisamos diretamente do editor.
No entanto, a maneira mais simples e fácil de seguir este tutorial é usar o GitHub Desktop.
Agora que você está pronto, vamos continuar com o negócio de contribuir para o projeto.
Contribuindo
Torne-se um contribuidor Open Source em 10 passos.
Tempos estimado: menos de 30 minutos.
Passo 1: de um Fork nesse repositório
O objetivo aqui é fazer uma cópia desse projeto e colocar na sua conta.
Um repositório (repo) é como o projeto é chamado no GitHub e o Fork é uma cópia dele.
Um fork de projeto terá o símbolo de um garfo ao lado.
Seu Fork terá seu nome de usuário do GitHub.
Isso levará um momento enquanto o projeto é copiado para o seu disco rígido. Eu recomendo que você mantenha o caminho padrão que geralmente é .. \ Documents \ GitHub.
Agora você tem uma cópia local do projeto.
Passo 3: Crie uma nova branch
Depois que o repositório for clonado e você o abrir na área de trabalho do GitHub, é hora de criar um novo ramo.
Uma ramificação é uma maneira de manter suas alterações separadas da parte principal do projeto chamada `Mestre '. Por exemplo, se as coisas derem errado e você não estiver satisfeito com as alterações, basta excluir a ramificação e o projeto principal não será afetado.
Clique em Current branch
Em seguida, clique em New
Dê um nome a sua branch
Clique em Create branch
Você pode dar o nome que desejar, mas como esse é um ramo para adicionar um cartão com o seu nome ao projeto, chamá-lo de `seu nome do cartão 'é uma boa prática, pois mantém clara a intenção desse ramo.
Publique sua nova branch no Github
Agora você criou uma nova branch separada da master.
Para as próximas etapas, verifique se você está trabalhando neste ramo. Você verá o nome da filial em que se encontra, na parte superior central do aplicativo de desktop do GitHub, onde diz Current branch.
Não trabalhe na branch master
Passo 4: Abra o arquivo index.html
Agora precisamos abrir o arquivo que vamos editar com seu editor de código favorito.
Encontre a pasta do projeto no seu computador. Se você manteve o padrão, deve ser algo como seu-computador> Documentos> GitHub> Contribua para este projeto
O arquivo index.html está diretamente na pastaContribute-To-This-Project.
Abra seu editor de código (Sublime, VS Code, Atom..etc) e use o comando Open file e localize o arquivo index.html do diretório principal do projeto
Como alternativa, você pode localizar o arquivo no disco rígido, clicar com o botão direito e abrir com o seu editor.
Agora você tem o arquivo que deseja editar aberto no seu editor e está pronto para começar a fazer alterações.
Passo 5: Copie o modelo do cartão
Faremos uma cópia do modelo do cartão para começar a trabalhar nele
Role para baixo até o final do arquivo, onde você encontrará a seção == TEMPLATE ==
Copie tudo dentro do quadrado vermelho da imagem, do comentário Contributor card START ao comentário Contributor card END
Cole a coisa toda diretamente acima do comentário indicando
Verifique se há uma única linha de espaço entre o início do cartão e o último final do cartão. É uma boa prática manter nosso código o mais claro possível
Verifique se o seu recuo está correto e corresponde ao modelo
Agora esse é seu cartão para você personalizar e editar.
Passo 6: Aplique suas mudanças
Agora começaremos a editar o html, alterando os campos personalizáveis em nosso cartão.
Substitua 'Name' com seu nome
Nota: não mude class="name"
Insira o URL da sua conta do Twitter href="Insert URL here"
Digite sua alça no campo de texto
Se você preferir usar um contato que não seja o Twitter, será necessário substituir o ícone do twitter <i class="fa fa-twitter"></i> indo ao Font Awesome Icons procurando o ícone certo e substituindo apenas a parte fa-twitter pelo novo ícone comofa-facebook por exemplo. Depois siga os mesmos passos acima.
Conte-nos algo sobre você
Mantenha isso curto e agradável. Pense nisso mais como um tweet do que uma postagem no blog
Compartilhe com a comunidade 3 links para recursos úteis para o desenvolvimento web
Pode ser qualquer coisa, um vídeo, uma palestra, um podcast, um artigo, uma referência ou uma ferramenta
Se você é iniciante, não se deixe intimidar por isso, compartilhe o que sabe, mesmo que você ache básico. Você ficará surpreso com quantas pessoas se beneficiarão
Link: Insira o link href="here" substituindo o #
Título: Escreva uma breve descrição title="here"
Nome: escreva o nome do recurso no campo de texto >here</a>
Garanta que você salvou todas as suas mudanças.
Teste suas mudanças. ISSO É IMPORTANTE!Abra o arquivo html no seu navegador (clicando duas vezes nele, por exemplo) e veja como será o seu cartão no site. Veja que a página inteira ainda parece a mesma e nada está quebrado. Clique nos seus links e verifique se eles estão funcionando.Abra o console (Ctrl + Shift + J (Windows / Linux) ou Cmd + Opt + J (Mac)) e verifique se não há mensagens de erro.
Ótimo, você terminou de editar seu código! As próximas etapas enviarão suas alterações para o GitHub e as enviarão para serem mescladas com o projeto principal.
Passo 7: Commit nas suas mudanças
Volte para o GitHub Desktop.
Suas alterações serão adicionadas automaticamente à área de preparação.
Isso significa que o Git registrou todas as alterações salvas.
Você pode ver isso refletido no aplicativo. Tudo o que você adicionou ao arquivo ficará em verde e as exclusões aparecerão em vermelho.
O próximo passo é chamado Commit
Isso aproximadamente significa "confirmar as mudanças"
É assim que o cabeçalho da área de trabalho do GitHub deve parecer
Observe o símbolo de bifurcação ao lado do nome do projeto no repositório atual Current repository
Seu Current branch terá o nome que você deu na etapa 3
Para o Commit você deve preencher o campo Summary
Esta é a mensagem de confirmação explicando o que você mudou
Nesse caso, "Adicionou as informações do meu cartão" seria uma mensagem razoável
Opcionalmente, você pode adicionar uma descrição mais detalhada em Description
Clique no botão Commit. Seu botão irá dizer algo como Commit to "your-branch-name"
Passo 8: Envie suas mudanças ao GitHub
Suas alterações agora estão salvas ou confirmadas. Mas eles são salvos apenas localmente, ou seja, no seu computador.
A sincronização de alterações locais com seu repositório no Github é chamada de Push. Você está "enviando" as alterações do seu repositório local para o repositório remoto no Github.
Clique no botão Push
Após alguns segundos, a operação está concluída e agora você tem exatamente a mesma cópia desta ramificação em sua máquina e no GitHub.
Passo 9: Envie um PR
Este é o momento que você estava esperando; enviando um Pull Request (PR).
Até agora, todo o trabalho que você fez esteve na bifurcação do projeto, que, como você se lembra, reside em sua própria conta do GitHub.
Agora é hora de enviar as alterações para o projeto principal a serem mescladas.
Isso é chamado de Pull Request porque você está pedindo ao mantenedor do projeto original para "puxar" suas mudanças em seu projeto.
Vá para a página principal de seu fork no GitHub (ele terá o ícone do fork e seu próprio nome de usuário na parte superior).
Na parte superior do repositório, você verá uma mensagem destacada de solicitação de recebimento com um botão verde.
Clique em Compare and pull request
Isso é o que uma página Open a pull request parece.
LEMBRE-SE você está tentando mesclar sua ramificação com o projeto original e não com a ramificação Master no seu fork.
A imagem abaixo fornece uma idéia de como deve ser o cabeçalho da sua solicitação pull.
À esquerda está o projeto original, seguido pelo ramo mestre. À direita está o seu Fork e o ramo que você criou.
Crie um pull request:
Escreva um título
Adicione informações opcionais na descrição
Clique em Create pull request
Não se assuste com todas as opções. Você só precisa executar essas três etapas por enquanto.
Deixe a opção "Permitir edições dos mantenedores" marcada.
Agora, um Pull Request será enviado ao mantenedor do projeto. Assim que for revisado e aceito, suas alterações aparecerão na página da web do projeto.
Passo 10: Comemore!
É isso aí. Você conseguiu! Você já contribuiu para o código aberto no GitHub.
Suas alterações não serão visíveis imediatamente; primeiro eles precisam ser revisados, aceitos e mesclados pelo mantenedor do projeto. Depois que eles forem mesclados, seu cartão estará visível e estará na página.
É muito normal que um revisor solicite alterações em um PR. Pense nisso como uma boa prática, se acontecer com você. Fique de olho nos comentários e nas alterações solicitadas. Depois de fazer as alterações solicitadas (de volta ao seu ramo), tudo o que você precisa fazer é confirmar e enviar as alterações. O PR será atualizado automaticamente com as novas alterações.
Prometo que tentarei revisar e mesclar o mais rápido possível, mas faço isso no meu tempo livre, por isso é inevitável um atraso de alguns dias.
Próximos passos
Volte em um tempo para verificar sua solicitação de solicitação mesclada.
Você deve receber um email do GitHub quando suas alterações forem aprovadas ou se alterações adicionais forem solicitadas. E quando o PR for finalmente mesclado ao mestre e seu cartão foi adicionado.
Se você achou este projeto útil, dê a ele: estrela: ⭐ no topo da página e Tweet sobre ele para ajudar a espalhar a palavra
Este é um projeto de código aberto. Além de contribuir com seu board, você pode ajudar a corrigir bugs, melhorias ou novos recursos. Abra um issue ou envie uma nova pull request
Obrigado por contribuir com este projeto. Agora você pode ir em frente e tentar contribuir com outros projetos; procure o rótulo [ para obter opções de contribuição para iniciantes.
Também estou procurando colaboradores para me ajudar na revisão e mesclagem de PRs. Se você deseja obter uma prática mais avançada do Git, envie-me um DM no Twitter.
Também é particularmente inspirado pela grande comunidade em torno de #GoogleUdacityScholars A bolsa de estudos do Desafio do Google: desenvolvedor Web front-end, turma da Europa de 2017.
para obter opções de contribuição para iniciantes.