Uma das melhores maneiras de conseguir colaboradores para o seu projeto de código aberto é fornecer uma versão preliminar para o colaborador começar. Uma das melhores maneiras de pedir ajuda é fornecer o que o senhor tem até o momento e permitir que um mentor o examine e dê sugestões. Em ambos os casos, o senhor precisará colocar o código em algum lugar acessível a todas as partes e, como o GitHub dominou o mundo da hospedagem de código, qual a melhor plataforma para fazer isso?
Como as solicitações pull fazem muito barulho e o código que o senhor deseja compartilhar nem sempre é material de mesclagem, a próxima melhor maneira é fornecer um gist do GitHub. Os gists são fáceis de criar manualmente, mas eu queria um método automatizado para criar gists, então recorri ao pretty-diff‘s gist-diffum único comando que cria um gist do GitHub com git diff conteúdo.
Instalação e configuração
Comece instalando pretty-diff:
npm install -g pretty-diff
A próxima etapa é garantir que a configuração global do git saiba seu nome de usuário do GitHub:
git config --global github.user "MyGitHubUsername"
A última etapa é acessar o GitHub e criar um arquivo Token de acesso pessoal (não se esqueça de marcar a caixa de seleção “Create gist”) para a funcionalidade pretty-diff fornece. Depois de criar o token, execute o seguinte:
git config --global gist-diff.token "######################"
Agora estamos prontos para usar o gist-diff!
Criando um Gist
Depois de criar as alterações que gostaria de compartilhar, execute gist-diff para enviar suas alterações para o GitHub:
# just execute the command! gist-diff
gist-diff cria um gist e, em seguida, abre seu navegador para o URL do gist.
Eu gostaria de ter conhecido o pretty-diff mais cedo e, a partir de agora, ele será um dos primeiros utilitários que instalarei em cada novo computador de trabalho. Compartilhar código é um dos luxos dos cenários modernos de código aberto, e a capacidade de criar uma lista das alterações atuais com um comando economiza muito tempo.
