Guias de projetos

GitHub Star, Watch e Fork: qual você deve usar?

Use Star para salvar um repositório, Watch para assinar sua atividade e Fork quando precisar de um repositório separado para trabalhar. Essas ações atendem a necessidades diferentes. Escolher uma não significa que você precise escolher as três.

Equipe editorial do GitHubStart · Atualizado

Escolha conforme o que deseja fazer

Imagine encontrar uma biblioteca útil de CSV. Se quiser ler depois, dê uma Star. Se sua aplicação depender dela e você quiser atualizações sobre versões, configure as notificações de Watch. Se pretende alterar o analisador em seu próprio repositório, considere um fork e siga as instruções de contribuição.

  • Star: um favorito e uma manifestação de interesse; não uma contagem de instalações.
  • Watch: assinaturas da atividade do repositório, com configurações de notificação que controlam o que você recebe.
  • Fork: um repositório separado conectado ao original, com seu próprio espaço de colaboração.

Evite confundir favoritos com notificações

Se você deu uma Star a um projeto mas não recebe notificações de versões, confira as configurações de Watch em vez de dar Stars repetidamente. Escolha os eventos necessários e depois revise suas preferências de entrega de notificações do GitHub. Por outro lado, se a caixa de entrada estiver cheia, revise as assinaturas em vez de remover um favorito útil.

Para um projeto que você consulta apenas ocasionalmente, comece com uma Star. Para uma dependência mantida em produção, decida quais atualizações precisam ser revisadas e quem da equipe responderá. Assim, as configurações de notificação integram um fluxo de trabalho, em vez de servirem como sinal de popularidade.

Interprete os contadores com cuidado

Como mantenedor, compare esses contadores com a qualidade das issues, relatos de configuração bem-sucedida e contribuições. Um fork pode ser um experimento que nunca vira um pull request. Uma Star pode ser um lembrete, e não adoção. Evite apresentar essas contagens como usuários ativos verificados.

O GitHubStart verifica novas Stars manuais elegíveis para seu sistema de pontos. Acompanhar um repositório ou criar um fork não substitui essa ação, e nenhuma ação garante que outro desenvolvedor dará uma Star ao seu projeto.

Perguntas frequentes

Dar uma Star a um repositório significa acompanhá-lo automaticamente?

Não use o botão Star como configuração de notificações. Confira Watch e suas preferências de notificação para receber a atividade do repositório que interessa a você.

Preciso de um fork apenas para experimentar um projeto?

Muitas vezes, você pode seguir o README usando um download, pacote ou clone. Crie um fork quando precisar de seu próprio repositório para alterações; siga o fluxo documentado do projeto.

Stars do GitHub são o mesmo que pontos do GitHubStart?

Não. Stars são ações no GitHub. Pontos do GitHubStart são lançamentos separados em um registro, concedidos somente quando suas regras de elegibilidade e verificação são atendidas.

Referências