Os programadores do GitHub costumam adicionar capturas de tela ou GIFs animados às solicitações de pull do repositório. Essas técnicas são definitivamente mais atraentes do que fazer alguém ler várias linhas de texto simples. Adicionar capturas de tela estáticas é útil se você deseja inserir alterações visuais ou fotografias embutidas. Uma animação GIF é uma boa maneira de demonstrar os fluxos do processo e o movimento do cursor do mouse.
O tutorial a seguir mostrará desde o início como adicionar imagens de captura de tela e animação GIF nas solicitações pull do GitHub. Mesmo que nunca tenha usado o GitHub antes, você pode usar essas etapas para começar.
1. Adicionar um novo repositório e filial
Se você é novo no mundo do GitHub, siga o procedimento aqui para criar sua conta.
Clique no sinal “+” no canto superior direito para criar um novo repositório. Lembre-se de marcar a opção “Inicializar este repositório com um README”.
No próximo estágio, adicione um branch ao seu repositório usando o menu suspenso mostrado abaixo. Aqui, o branch “Guten-tag” foi adicionado ao repositório “Hola-World”.
O objetivo de um branch no GitHub é ajudar o desenvolvedor a trabalhar em recursos e correções de bugs separados do branch master de produção.
2. Crie uma captura de tela ou animação
Para adicionar capturas de tela, você precisa de um bom software de captura de tela. No Windows 10, algumas das melhores e mais fáceis ferramentas são Snip & Sketch e Snipping tool.
Para adicionar animação GIF, você precisa de uma boa ferramenta de captura de tela de vídeo. Uma ferramenta recomendada é o Recordit, que é extremamente fácil de usar para um rápido screencasting. Isto é disponível para download direto para Windows e macOS.
Após a instalação, você pode gravar alguns segundos de qualquer tela usando um botão Gravar. Todos os seus screencasts recentes serão visíveis no menu da bandeja do sistema e abertos em um navegador.
Como as solicitações de pull do GitHub não permitem arquivos de vídeo (MP4, etc.), você precisará convertê-los em arquivos GIF. Na verdade, ele suporta um número muito limitado de arquivos personalizados: JPG, JPEG, GIF, PNG, DOCX, PPTX, PDF, TXT, XLSX e ZIP. Você pode facilmente converter um MP4 em GIF usando Ezgif ou qualquer outra ferramenta online.
O seguinte arquivo GIF criado será inserido em uma solicitação de pull do GitHub. Ele demonstra a sequência simples de adicionar um novo branch a um repositório GitHub usando o aplicativo GitHub Desktop.
3. Adicione capturas de tela ou animações às solicitações pull do GitHub
Volte para o branch que você criou anteriormente e navegue até “Solicitações de pull”. Aqui, você pode editar os dados da solicitação pull em um menu de três pontos.
Uma vez no modo de editor, você pode anexar a imagem da captura de tela e os arquivos de animação GIF na opção “Anexar arquivos”. Se você estiver fazendo um commit pela primeira vez no repositório de branch do GitHub, clique em “commit”. Caso contrário, a escolha é “atualizar o comentário”.
A captura de tela e a animação criadas foram adicionadas com sucesso ao branch do GitHub e, por sua vez, ao repositório.
GitHub tem tudo a ver com colaboração com outros desenvolvedores. Se eles gostarem de suas alterações propostas, eles podem mesclá-lo upstream em seu próprio repositório. Isso é feito usando a opção “solicitação de recepção de mesclagem”.
Uma animação é definitivamente uma boa maneira de atrair a atenção de outros desenvolvedores na comunidade GitHub. Ao concluir este tutorial, você aprendeu como adicionar capturas de tela e animações GIF ao seu repositório GitHub e a qualquer um de seus branches. Se você não gosta do GitHub, pode verificar esta lista de alternativas ao GitHub.
Relacionado:
