Neste artigo
- O que o recrutador olha primeiro
- Os sinais de um repositório bem arrumado
- Como o perfil conta a sua história
- GitHub na sua carreira
- Checklist do repositório bem arrumado
- Os sinais que afastam o recrutador
- Esqueleto de um README que funciona
- Todo projeto meu precisa estar no GitHub?
- Commits pequenos fazem diferença?
- Devo escrever README em português ou inglês?
- GitHub vazio atrapalha?
- Devo apagar os repositórios antigos e ruins?
- Nomes de commit em português ou inglês?
O seu GitHub é lido por recrutador mesmo sem você junto, e os sinais que ele procura são visíveis no perfil em segundos. Um repositório arrumado fala de método; um conjunto de repositórios sem README fala de improviso. Este guia mostra o que ajustar para o perfil contar a sua história.
O recrutador olha o README, o histórico de commits e se o código roda. Um repositório com README claro, commits pequenos e um projeto de destaque transmite profissionalismo. O passo a passo para começar está no guia de Git.
O que o recrutador olha primeiro
A ordem típica é o perfil, o repositório em destaque e o README. O perfil precisa dizer quem você é e o que busca. O repositório destacado é o seu cartão de visita, e o README é o texto que faz o recrutador decidir se vale clicar mais fundo.
Os sinais de um repositório bem arrumado
Um bom repositório tem README, commits de tamanho razoável e um código que outro dev consegue rodar. O commit pequeno com mensagem descritiva conta o avanço do projeto, e o recrutador lê isso como sinais de método de trabalho, não só de habilidade.
💡 Dica: fixe um projeto no perfil que represente o seu melhor trabalho. É a primeira coisa que o recrutador vê, e um projeto bom na vitrine vale mais que dez soterrados na lista.
Como o perfil conta a sua história
O GitHub fala pela sequência dos seus projetos e pela constância dos commits. Um gráfico de atividade consistente, mesmo que suave, sinaliza trabalho contínuo. Um perfil com um pico isolado e silêncio depois não conta a mesma história de quem constrói com regularidade.
ℹ️ Info: constância vale mais que intensidade. Fazer um commit por semana em um projeto real supera um fim de semana de atividade intensa seguido de meses parado.
GitHub na sua carreira
O GitHub é o portfólio vivo que o currículo aponta. Ele se conecta com o portfólio e com a busca, porque o recrutador passa do documento para o perfil para confirmar o que leu. Um repositório limpo converte essa checagem em aprovação.
Checklist do repositório bem arrumado
Um repositório profissional se constrói em poucos passos, e a ordem importa menos que a completude. Confira item por item antes de enviar o perfil para um recrutador.
- Nome que já se explica: o nome do repositório descreve o projeto, não é um apelido interno.
- README na raiz: o que o projeto faz, como rodar e a decisão principal.
- Commits pequenos e descritivos: uma mudança por commit, com mensagem que conta o porquê.
- Projeto destacado: fixe no perfil o trabalho que melhor representa você.
- Instrução de execução: dependências, comando de subida e variáveis necessárias.
- Licença e autor: uma linha que indica quem fez e sob que termos.
💡 Dica: abra o seu perfil em uma aba anônima e tente entender cada repositório só pela listagem. O que não se explica sozinho é candidato a ganhar um README melhor ou sair da vitrine.
Os sinais que afastam o recrutador
O primeiro sinal ruim é o repositório sem descrição: o recrutador abre e não faz ideia do que é aquilo. O segundo é o commit gigante e único, com mensagem de up ou ajustes, que não conta a história do trabalho. Esses dois sozinhos passam a impressão de improviso, mesmo que o código seja bom.
Outro afastador é o código que não roda por falta de instrução. Um projeto que exige adivinhar dependência e comando transfere o esforço para quem lê, e o recrutador não vai resolver isso por você. Facilidade de execução é parte do que se avalia em um perfil público.
Por fim, o perfil que mistura projeto pessoal com exercício de tutorial, sem separar os dois, também confunde. O recrutador precisa identificar rápido qual é o seu trabalho principal. Uma organização por destaque, com os projetos fortes no topo, resolve essa leitura sem apagar o histórico.
ℹ️ Info: o recrutador raramente lê o código inteiro; ele checa amostras. O README, o histórico de commit e um trecho do código principal bastam para a primeira impressão, então esses três merecem atenção dobrada.
Esqueleto de um README que funciona
Um README eficiente responde às perguntas do visitante em uma ordem previsível, sem se alongar. O esqueleto abaixo serve como base para quase todo projeto de portfólio.
# Nome do projeto
O que o projeto resolve, em uma frase.
## O problema
Contexto de por que ele existe e quem ele atende.
## Funcionalidades
O que o sistema entrega, em itens curtos.
## Stack
Linguagem, framework e banco usados.
## Como rodar
Dependências e comandos de instalação, subida e teste.
## Decisões
A escolha de arquitetura mais importante e o porquê.
## Autor
Seu nome e o link do perfil.
O esqueleto não é para copiar à risca, e sim para lembrar que o README é uma página de entrada. Ele responde o que é, por que existe e como rodar antes de qualquer outra coisa, e é isso que o recrutador quer saber em segundos quando abre o repositório.
README claro entra na mesma conta dos commits: são ambos sinais de método que o recrutador usa para inferir como você trabalharia no time. Quem documenta a própria entrega demonstra, sem dizer, a capacidade de comunicar que o trabalho em equipe exige de todo dev.
Portfólio e preparação se encontram na entrevista: quem documenta bem chega com roteiro pronto, e o guia de entrevista técnica sem decoreba usa exatamente esse material como base.
Perguntas frequentes
Todo projeto meu precisa estar no GitHub?
Não. Só os que representam bem o seu trabalho. O perfil é uma vitrine, não um depósito de rascunho. Curadoria importa mais que volume.
Commits pequenos fazem diferença?
Sim. Commit pequeno com mensagem clara mostra como você trabalha. O recrutador lê o histórico como evidência de método.
Devo escrever README em português ou inglês?
Depende do mercado que você mira. Para vaga internacional, inglês. Para vaga local, português resolve. O essencial é existir README claro em qualquer idioma.
GitHub vazio atrapalha?
Atrapalha se você tem projetos fora dele, porque o recrutador não acha a evidência. Mesmo projetos antigos bem organizados valem mais que perfil vazio.
Devo apagar os repositórios antigos e ruins?
Pode arquivar ou tornar privado o que não representa o seu nível atual, em vez de deixar exposto. O perfil é uma vitrine, e curadoria vale mais que volume. Manter só o que agrega deixa a visita do recrutador mais direta e o seu melhor trabalho mais fácil de achar no meio da lista.
Nomes de commit em português ou inglês?
Acompanhe o idioma do seu projeto e do mercado que você mira. Para vaga internacional, o inglês ajuda; para projeto local, o português resolve. O essencial é a mensagem descrever o porquê da mudança, em qualquer idioma, porque é o histórico que o recrutador lê como evidência de método.