Torne útil a primeira visita ao repositório
Antes de compartilhar um link, abra seu repositório como alguém que nunca ouviu falar dele. A primeira tela deve explicar o problema, o usuário a que se destina e o caminho mais curto para ver um resultado. Uma captura de tela pode ajudar em uma ferramenta visual; um pequeno exemplo de entrada e saída costuma ser mais útil para uma biblioteca.
Para um validador de CSV imaginário, “Valide exportações CSV antes de importá-las para seu banco de dados” informa mais que “Um poderoso conjunto de ferramentas de dados”. Em seguida, mostre um arquivo inválido de exemplo, o comando para verificá-lo e o erro produzido.
- Coloque a finalidade e um exemplo funcional antes de uma longa lista de recursos.
- Informe os requisitos do ambiente de execução, as etapas de instalação e as limitações conhecidas.
- Inclua links para a licença, a documentação e o local para relatar problemas.
- Use tópicos precisos no repositório para que quem explora esse assunto encontre seu projeto.
Encontre seus primeiros leitores interessados
Escolha uma comunidade em que as pessoas já discutam o problema que você resolve. Uma ferramenta de dados em Python precisa de uma apresentação diferente da de uma ferramenta de design para navegador. Explique um caso de uso concreto e sobre o que deseja receber comentários. Informe que você mantém o projeto e leia primeiro as regras de publicação da comunidade.
Mantenha o experimento inicial pequeno: melhore o README, compartilhe um exemplo executável em um local adequado e responda às perguntas que surgirem. Se os leitores não conseguirem instalar o projeto, resolva isso antes de adicionar canais. Publicar repetidamente o mesmo link não substitui a solução dos problemas dos primeiros passos.
Peça uma estrela depois de entregar algo útil
Uma frase curta e opcional após o início rápido basta: “Se este projeto for útil para você, marque o repositório com uma estrela para encontrá-lo novamente”. Mantenha as instruções de instalação, a documentação e o suporte disponíveis, independentemente de a pessoa dar uma estrela.
O GitHubStart oferece um diretório público de descoberta e troca. Você pode cadastrar um repositório público sem fazer login no GitHubStart, explorar outros projetos e decidir quais quer apoiar. Dar uma estrela continua sendo uma ação manual, feita com login no GitHub. Cadastrar um repositório não promete uma quantidade de estrelas nem uma estrela em troca.
Mantenha um registro semanal de aprendizados
Registre a data, a alteração feita, onde a compartilhou, as perguntas recebidas e o que corrigiu. Compare as estrelas com sinais práticos, como instalações bem-sucedidas, problemas reproduzíveis e contribuições recorrentes. Um pico após uma publicação é uma correlação, não prova de que cada nova estrela veio daquela publicação.
Exemplo: se cinco leitores perguntarem como configurar um token, coloque as instruções de configuração antes do exemplo. Compartilhe o exemplo corrigido com esses leitores, em vez de publicar outro anúncio genérico de lançamento.
- Semana 1: verifique o início rápido em um ambiente limpo.
- Semana 2: compartilhe um caso de uso e responda aos comentários.
- Semana 3: publique as correções e explique o que mudou.
- Semana 4: mantenha o canal que gerou conversas úteis e reavalie os demais.
Perguntas frequentes
Como conseguir minhas primeiras 100 estrelas no GitHub?
Trate 100 como um marco, não como um resultado prometido. Comece com um projeto utilizável, um README claro e leitores interessados. As mesmas etapas valem com 5 ou 500 estrelas; o tempo necessário depende do público e do projeto.
Posso dar uma estrela a um repositório do GitHub sem fazer login?
Você pode explorar repositórios públicos e o GitHubStart sem uma conta no site. Para dar uma estrela, você precisa fazer login no GitHub por conta própria. O GitHubStart não realiza essa ação por você.
Mais estrelas significam mais usuários?
Não necessariamente. Alguém pode salvar um repositório para depois sem instalá-lo. Acompanhe a adoção e os comentários separadamente da contagem de estrelas.