Do commit ao deploy: entenda a língua de quem desenvolve em equipe
Commit, branch, PR, merge, deploy e muito mais: um guia para entender a conversa dos desenvolvedores, com exemplos de Git, revisão, CI/CD e trabalho em equipe.
As vozes dependem do navegador e do dispositivo; algumas precisam de internet. Blocos de código não são narrados.
Você entra na conversa da equipe e alguém manda:
“Cria uma branch, faz os commits, sobe um PR e me marca no review. Se a pipeline passar, a gente faz o merge e agenda o deploy em produção.”
Parece que o desenvolvimento de software veio com um pacote de idioma que esqueceram de instalar.
Mesmo quem já programa pode estranhar esse vocabulário quando começa a trabalhar com outras pessoas. E a dificuldade vai além do inglês: várias palavras representam etapas diferentes, embora apareçam juntas na mesma frase. Salvar um arquivo, fazer commit, dar push, aprovar um PR e realizar um deploy são ações diferentes.
Este artigo reúne os termos mais comuns de Git, revisão de código, automação, publicação e organização do trabalho. A proposta é explicar o que cada palavra significa e o que a equipe espera que aconteça quando alguém a utiliza.
Não existe um dicionário capaz de cobrir todos os times e ferramentas. Os nomes e combinados variam. Use este guia como referência e, ao entrar em um projeto, consulte também suas instruções de contribuição.
1. Git, GitHub e repositório: onde o trabalho começa
Git é um sistema de controle de versão distribuído. Ele registra a evolução de arquivos e permite trabalhar com diferentes linhas de desenvolvimento. Operações como consultar o histórico e criar commits podem acontecer localmente, sem conexão com um servidor. A introdução oficial do Git explica esse modelo.
Versionamento, ou controle de versão, é o acompanhamento organizado das mudanças. Ajuda a descobrir o que foi alterado, comparar estados e recuperar versões anteriores.
GitHub, GitLab e Bitbucket são plataformas que hospedam repositórios Git e acrescentam colaboração, permissões, revisões e automações. Git é a ferramenta de versionamento; a plataforma oferece serviços ao redor dela.
| Termo | Significado no trabalho |
|---|---|
| Repositório / repository / repo | O conjunto de dados versionados e seu histórico. Em uma cópia local comum, os dados do Git ficam no diretório .git. |
| Local | O que está no ambiente em que você trabalha, frequentemente seu computador. |
| Remoto / remote | Outro repositório com o qual o seu troca dados. Costuma estar em um servidor, mas também pode estar em outro caminho local. |
| Clone | Criar uma cópia local de um repositório existente, com histórico e configuração de acesso à origem; opções especiais podem limitar o histórico baixado. |
| Fork | Um repositório separado, relacionado ao original pela plataforma. É comum para contribuir sem permissão de escrita no projeto de origem. |
| Upstream repository | O projeto de origem em relação a um fork. A palavra upstream também aparecerá com outro sentido no Git. |
Você pode fazer um fork no GitHub e depois clonar esse fork no computador. Também pode clonar diretamente um repositório da equipe. Fork e clone resolvem necessidades diferentes. Veja as referências de clone e forks no GitHub.
Três arquivos merecem atenção na chegada: o README apresenta o projeto; o CONTRIBUTING explica como contribuir, quando existe; e o .gitignore define padrões de arquivos não rastreados que o Git deve ignorar.
O .gitignore não apaga arquivos do histórico nem deixa de rastrear automaticamente o que já foi versionado. Essa distinção está na documentação do próprio Git. Colocar .env nesse arquivo depois de publicar uma senha não desfaz a exposição.
2. Do arquivo editado ao commit: as etapas locais
Imagine uma correção em um exportador de CSV. Você abre o arquivo, muda uma função e salva. O arquivo mudou no disco, mas ainda falta registrar essa alteração no histórico.
| Termo | O que significa |
|---|---|
| Working tree / working directory | A árvore de arquivos em que você está trabalhando. |
| Tracked | Arquivo que o Git já acompanha. |
| Untracked | Arquivo que ainda não está sendo acompanhado pelo Git. |
| Modified | Arquivo rastreado com alterações em relação ao estado usado na comparação. |
| Staging area / index | Área de preparação do conteúdo que entrará no próximo commit. |
| Stage / staged | Preparar uma alteração, ou dizer que ela já está nessa área. |
| Commit | Um registro de um estado do projeto, ligado ao histórico e acompanhado de metadados e mensagem. |
| Hash / commit ID / SHA | O identificador usado para referenciar um commit, frequentemente mostrado de forma abreviada. |
O git add coloca conteúdo na área de preparação. Ele também serve para alterações em arquivos que já existem. O git commit registra o conteúdo preparado. Se você fizer add, editar novamente o mesmo arquivo e só então fizer commit, a edição posterior não estará automaticamente incluída: será necessário prepará-la também. A documentação de registro de mudanças demonstra essa separação.
Commit é um registro local. Ele não envia nada sozinho para GitHub, GitLab ou produção. Pense em uma sequência de registros que você poderá compartilhar depois.
Uma boa commit message explica a alteração. Compare ajustes com fix: corrige exportação de nomes com acento. A segunda facilita a vida de quem precisar entender o histórico — inclusive você daqui a três meses.
Outros termos aparecem na investigação:
- Status: situação atual dos arquivos e da branch;
git statusé uma boa primeira consulta. - Diff: comparação entre estados.
git diffnormalmente mostra mudanças ainda não preparadas;git diff --stagedmostra o que está preparado em relação ao último commit. - Hunk: um trecho de alterações dentro de um diff. É possível preparar apenas partes de um arquivo.
- Log: histórico de commits, consultado com
git log. - Blame: indicação do commit que alterou por último cada linha no contexto consultado. Serve para buscar contexto; o nome não transforma a ferramenta em tribunal.
As referências de diff e blame detalham essas consultas.
3. Branch, main e HEAD: em qual linha você está trabalhando?
Branch é uma linha de desenvolvimento identificada por um nome. Tecnicamente, seu nome aponta para um commit e avança conforme você registra novos commits nessa linha. Criar uma branch não exige duplicar manualmente a pasta do projeto.
Uma feature branch concentra o trabalho de uma funcionalidade; uma branch de correção pode ter nome como fix/exportacao-csv. Esses prefixos são convenções do projeto, não regras obrigatórias do Git.
main é um nome comum para a branch principal. Você também encontrará master, develop e outros nomes. O Git não atribui poderes especiais à palavra main, e uma branch principal não necessariamente corresponde ao que está em produção.
Checkout significa selecionar um estado para trabalhar. O comando git checkout reúne mais de uma função; git switch oferece uma forma específica de trocar ou criar branches.
HEAD indica o ponto atual do trabalho. Normalmente aponta para a branch selecionada. Em detached HEAD, aponta diretamente para um commit, sem estar associado a uma branch local. Isso é útil para inspeções; se quiser preservar novos commits feitos ali, crie uma branch que os alcance.
Esses conceitos são tratados nas referências de branches, switch e checkout.
| Nome ou expressão | Interpretação |
|---|---|
origin |
Nome convencional dado ao remoto ao clonar. Pode ser alterado. |
origin/main |
Referência local que acompanha o estado conhecido da branch main daquele remoto. Não é uma consulta ao servidor em tempo real. |
| Tracking branch | Branch local configurada para acompanhar outra branch. |
| Upstream branch | Branch ou referência acompanhada pela branch local, usada em comparações e operações como pull. |
| Ahead / behind | Quantos commits sua branch tem a mais ou a menos em relação à referência comparada. |
| Diverged | Os dois lados têm commits próprios; nenhum é apenas uma continuação direta do outro. |
Repare na ambiguidade: upstream pode ser a branch acompanhada ou um nome escolhido para o remoto do projeto original. O capítulo sobre branches remotas ajuda a distinguir os usos.
4. Fetch, pull e push: como as cópias conversam
Essas três palavras aparecem tanto que vale separá-las com cuidado.
| Operação | O que faz | Exemplo de intenção |
|---|---|---|
| Fetch | Busca objetos e atualiza referências conforme a configuração, sem integrar automaticamente o resultado à branch em que você trabalha. | “Quero verificar o que chegou ao remoto.” |
| Pull | Busca atualizações e tenta integrá-las à branch atual, conforme opções e configuração. | “Quero incorporar as novidades à minha linha de trabalho.” |
| Push | Envia os objetos necessários e solicita a atualização de referências no outro repositório. | “Quero disponibilizar meus commits no remoto.” |
Um pull pode envolver fast-forward, merge ou rebase, conforme a forma escolhida. Tratar pull como sinônimo obrigatório de merge esconde uma diferença que afeta o histórico. Consulte as referências de fetch, pull e push.
Push não envia as edições que ficaram soltas no seu editor. Primeiro elas precisam fazer parte de commits alcançados pelas referências enviadas. E push só provoca deploy se houver uma automação configurada para isso.
Um push rejeitado pode indicar que a branch remota avançou, que existem regras de proteção ou que faltam permissões. A mensagem explica o motivo; não transforme --force em resposta automática.
Force push permite certas atualizações que reescrevem a história alcançada por uma referência remota. --force-with-lease acrescenta uma verificação do estado esperado, mas continua sendo uma operação que exige entender o histórico e o combinado do time.
5. Merge, rebase, squash e conflito: como as mudanças se encontram
Você corrige o CSV enquanto outra pessoa altera a mesma área. Mais cedo ou mais tarde, essas linhas de trabalho precisam se encontrar.
Merge integra históricos. Dependendo da relação entre eles e das opções utilizadas, pode criar um merge commit, que registra a união com mais de um pai.
Se a branch de destino apenas estiver atrás da outra, pode ocorrer um fast-forward: o ponteiro avança até o commit mais recente, sem precisar criar um commit de união. Essa possibilidade está na documentação de merge.
Merge conflict, ou conflito de mesclagem, surge quando o Git não consegue resolver uma combinação automaticamente. Pode envolver linhas, exclusões, renomeações ou arquivos binários. Resolver um conflito exige escolher o resultado correto para o sistema e testar seu comportamento. Apagar os marcadores do conflito é só uma parte do trabalho.
Rebase reaplica commits sobre outra base e pode produzir uma história linear. Como os commits reaplicados ganham outro contexto, normalmente recebem novos identificadores. Também pode gerar conflitos. Reescrever commits já compartilhados exige coordenação, porque outras pessoas podem ter construído trabalho sobre eles. A documentação de rebase explica as consequências.
Squash combina alterações de vários commits em um resultado que poderá ser registrado como um commit. Em plataformas, squash and merge costuma resumir um PR em um commit na branch de destino. Você ganha uma unidade de histórico mais compacta e deixa de preservar ali a sequência original de commits. O GitHub documenta as estratégias de integração.
Cherry-pick reaplica a alteração de um commit escolhido sobre outra linha, normalmente criando um novo commit. É útil, por exemplo, ao levar uma correção específica para uma versão mantida do produto. Ele também pode conflitar e depende de verificar se aquela correção precisa de outras mudanças. Veja a referência de cherry-pick.
Backport é justamente a adaptação de uma mudança para uma versão ou linha mais antiga. Cherry-pick pode fazer parte disso, mas nem todo backport se resume a copiar um commit.
Nenhuma dessas estratégias garante sozinha um histórico “certo”. A escolha depende do projeto, do que já foi compartilhado e de como a equipe deseja investigar mudanças depois.
6. Stash, restore, reset e revert: quatro ideias diferentes
Quando alguém diz “desfaz isso”, pergunte o que precisa ser desfeito: uma edição local, a preparação de um arquivo, um commit ou o comportamento em produção?
| Termo | Uso principal | Cuidado |
|---|---|---|
| Stash | Guardar temporariamente alterações locais para retomar depois. | Por padrão, não inclui arquivos não rastreados; opções mudam esse comportamento. Não substitui o compartilhamento de commits. |
| Restore | Restaurar conteúdo de arquivos na árvore de trabalho ou no index, conforme as opções. | Pode descartar edições locais. |
| Reset | Mudar referências e/ou o conteúdo do index e da árvore de trabalho, conforme a forma utilizada. | Modos como --hard podem descartar trabalho. |
| Revert | Criar um novo commit que aplica a inversão de mudanças de outro commit. | Mantém o registro histórico, mas pode exigir resolução de conflitos. |
| Amend | Refazer o commit mais recente com outro conteúdo ou mensagem. | Substitui sua identidade; se já foi compartilhado, coordene a alteração. |
| Reflog | Registro local das movimentações de referências, útil para localizar estados anteriores. | Tem retenção e alcance limitados; não é garantia de recuperação de qualquer arquivo. |
As referências de stash, restore, reset, revert, commit e reflog são boas consultas antes de uma operação de recuperação.
Um revert altera o código por meio de outro commit. Um rollback de deploy, que veremos adiante, muda a versão em execução. Uma ação não implica automaticamente a outra.
7. PR, MR e code review: a conversa antes da integração
Pull request (PR) é uma proposta de integração com contexto, comparação de alterações e espaço para revisão. Merge request (MR) é o nome usado pelo GitLab para esse tipo de colaboração. É um recurso da plataforma; não existe um comando universal git pull-request no Git básico.
Pull e pull request não são a mesma coisa. O primeiro é uma operação do Git. O segundo organiza uma proposta de mudança.
Um PR costuma comparar a base / target branch, que receberá as alterações, com a head / source branch, que as oferece. Confira a direção antes de abrir a solicitação. As documentações de PRs do GitHub e MRs do GitLab descrevem esses recursos.
| Expressão | O que a equipe quer dizer |
|---|---|
| Code review / review | Revisão das mudanças: comportamento, clareza, testes, riscos e adequação ao projeto. |
| Reviewer | Pessoa convidada a revisar. |
| Assignee | Pessoa atribuída à demanda ou solicitação; o significado exato depende do time. |
| Draft / WIP | Rascunho ou work in progress: trabalho em andamento, que pode receber comentários antes de estar pronto. |
| Approve / approval | Aprovação registrada na revisão. |
| Request changes | Solicitação de ajustes. |
| Comment / thread | Comentário ou sequência de discussão, frequentemente ligada a um trecho do diff. |
| Resolve conversation | Marcar uma discussão como resolvida; isso não prova sozinho que o problema foi corrigido. |
| LGTM | Looks good to me: “parece bom para mim”. Pode ser um comentário informal, sem substituir a aprovação exigida. |
| Nit / nitpick | Observação pequena de estilo ou acabamento. É útil indicar se ela impede a integração. |
| Blocking / non-blocking | Comentário que precisa ser atendido antes de prosseguir, ou sugestão que não bloqueia. |
Checks são verificações associadas à mudança. Required checks são as exigidas pelas regras do projeto. Branch protection e rulesets podem exigir revisões, verificações e outras condições. CODEOWNERS associa áreas do repositório a responsáveis e pode participar dessas exigências.
Uma aprovação não garante que o botão de merge estará liberado: podem faltar verificações ou outras condições. As referências de reviews e branches protegidas explicam essas relações.
8. Build, pipeline e CI/CD: o trabalho automatizado
DevOps reúne práticas e uma cultura de colaboração entre desenvolvimento e operação, com automação e feedback para entregar e manter o software. A introdução da AWS a DevOps explica essa aproximação.
Depois do push ou da abertura do PR, começam a aparecer verificações. Você ouve que “o build quebrou” ou que “a pipeline ficou verde”.
Build é o processo de preparar o software para uso ou distribuição. Pode compilar, transformar arquivos, resolver recursos e empacotar resultados. Mesmo uma aplicação com linguagem interpretada pode ter uma etapa de build.
Artifact, ou artefato, é uma saída produzida pelo processo: um pacote, um executável, arquivos de uma aplicação web ou um relatório. A documentação de artefatos do GitHub Actions dá exemplos.
| Termo | Significado |
|---|---|
| Pipeline | Conjunto organizado de tarefas automatizadas, com suas dependências e condições. Pode ter partes paralelas. |
| Workflow | Fluxo de trabalho; em ferramentas como GitHub Actions, também é o nome de uma automação configurada. |
| Trigger / event | Evento que inicia a execução, como push, PR, horário agendado ou acionamento manual. |
| Job | Unidade de trabalho da automação. |
| Step | Etapa dentro de um job, como executar um comando. |
| Runner / agent | Ambiente ou processo que executa os jobs. |
| Cache | Dados reaproveitados para acelerar execuções. Tem finalidade diferente de um artefato de entrega. |
| Green / passed | As verificações consideradas naquela execução passaram. |
| Red / failed | Pelo menos uma verificação relevante falhou. |
As ferramentas usam esses nomes com diferenças. A introdução ao GitHub Actions mostra a relação entre eventos, workflows, jobs, steps e runners.
CI — continuous integration, ou integração contínua: prática de integrar mudanças com frequência e verificar o resultado, normalmente com build e testes automatizados. Ter um servidor de CI ajuda; deixar branches isoladas por meses continua criando dificuldades de integração.
Continuous delivery — entrega contínua: manter o software em condição de ser entregue por um processo confiável. A ida para produção pode depender de uma decisão ou aprovação.
Continuous deployment — implantação contínua: mudanças aprovadas pelas verificações seguem automaticamente para produção, sem uma aprovação manual para cada alteração.
A sigla CD pode significar os dois últimos conceitos. Descubra qual deles o time utiliza. A referência de CI/CD da AWS apresenta essa distinção.
Uma pipeline verde informa que aquelas verificações passaram, naquelas condições. Pode faltar um teste importante, uma validação de negócio ou uma dependência que só aparece em outro ambiente.
9. Testes e qualidade: o que exatamente passou?
| Termo | Tradução para o cotidiano |
|---|---|
| Lint / linter | Análise de padrões, problemas e regras no código, geralmente sem executar o programa completo. |
| Formatter | Ferramenta que aplica formatação consistente. |
| Static analysis | Análise do código sem executar seu comportamento normal; pode procurar problemas de tipos, fluxo ou segurança. |
| Unit test | Teste de uma unidade pequena de comportamento. |
| Integration test | Verificação da interação entre componentes. |
| E2E / end-to-end | Teste de um fluxo de ponta a ponta, como entrar no sistema e concluir uma exportação. |
| Smoke test | Conjunto pequeno de verificações essenciais para identificar rapidamente falhas graves. |
| Regression test | Teste que ajuda a detectar o retorno de um problema ou a quebra de comportamento que funcionava. |
| Coverage | Medida de quanto do código foi exercitado segundo um critério. Não mede sozinha a qualidade dos testes. |
| Flaky test | Teste que alterna entre passar e falhar sem uma mudança intencional relevante, frequentemente por tempo, estado ou dependências. |
| Mock / stub | Substitutos de dependências em testes; podem simular respostas ou permitir verificar interações. A distinção exata depende da ferramenta. |
| QA — quality assurance | Práticas de garantia da qualidade; em algumas equipes também designa uma função profissional. |
As documentações do pytest sobre testes instáveis, do Playwright sobre boas práticas e do coverage.py ajudam a aprofundar esses temas.
No exemplo do CSV, conferir se a tela abre não prova que um nome acentuado será exportado corretamente. O teste precisa observar o comportamento que você pretende garantir.
10. Ambiente, deploy e release: chegando ao usuário
Environment, ou ambiente, é uma combinação de aplicação, configuração, infraestrutura e dados para determinada finalidade.
| Ambiente | Finalidade habitual |
|---|---|
| Local | Desenvolvimento no ambiente individual. |
| Development / dev | Desenvolvimento e integração; pode ser compartilhado. |
| Test / testing | Execução de verificações. |
| Staging / homologação / pre-production | Validação anterior à produção, buscando condições relevantes semelhantes. Os nomes e diferenças variam. |
| Production / prod / produção | Ambiente que atende ao uso real do produto. |
| Preview environment | Ambiente temporário para experimentar uma alteração, frequentemente ligado a um PR. |
| Sandbox | Ambiente destinado a experimentação ou isolamento; o nome não garante isolamento ou ausência de dados reais. |
Staging environment e staging area do Git são coisas diferentes. Um é um ambiente da aplicação; o outro prepara conteúdo para commit. A documentação de ambientes do GitLab mostra como plataformas organizam destinos de implantação.
Deploy / deployment é implantar uma versão ou mudança em um ambiente. Pode acontecer em homologação, produção ou outro destino. “Fiz deploy” fica mais claro quando você informa de qual versão e em qual ambiente.
Release pode designar uma versão disponibilizada do produto ou o ato de disponibilizá-la. Nas plataformas de repositório, também pode ser um registro com notas e arquivos associado a uma versão. Veja releases no GitHub.
Feature flag / feature toggle é um controle que permite variar o comportamento ou a disponibilidade de uma funcionalidade. Você pode fazer deploy de um recurso desativado e liberá-lo depois para determinado público. Por isso, deploy e liberação ao usuário podem acontecer em momentos diferentes, como explica a introdução do OpenFeature.
Outras palavras comuns nessa etapa:
- Rollout: processo de distribuir ou ativar uma mudança, às vezes gradualmente.
- Rollback: retorno a uma versão ou configuração anterior para conter um problema. Reverter código não desfaz automaticamente alterações em dados.
- Hotfix: correção urgente, frequentemente motivada por um problema em produção. A urgência muda a prioridade; a equipe ainda precisa verificar o que será entregue.
- Migration: mudança versionada na estrutura do banco de dados ou transformação de dados. Seu plano de reversão precisa considerar efeitos e compatibilidade.
- Health check: verificação de saúde de uma aplicação ou componente.
- Blue-green: estratégia com dois ambientes de referência e troca de tráfego entre eles.
- Canary: disponibilização inicial para uma parcela do tráfego ou dos usuários, com observação antes da expansão.
- Rolling update: substituição gradual das instâncias da aplicação.
As estratégias de implantação da AWS e a documentação de Deployments do Kubernetes detalham formas de distribuição e reversão.
Depois do deploy, entram logs, registros de eventos; metrics, medidas como taxa de erros; e traces, rastros de uma requisição atravessando componentes. São sinais usados em observabilidade, para entender o comportamento do sistema. O OpenTelemetry descreve esses sinais.
Um incident, ou incidente, é uma situação que prejudica o serviço e exige resposta. On-call é a escala de pessoas responsáveis por atender ocorrências. Postmortem é o registro posterior do incidente, de seus fatores e das ações de melhoria. O foco útil é aprender e reduzir recorrência, como propõe a referência de postmortems do Google SRE.
11. Tag, versão e changelog: como identificar uma entrega
Tag é uma referência com nome, usada frequentemente para marcar um ponto do histórico, como v1.4.2. Uma tag não significa que houve deploy. A documentação de tags do Git apresenta seus tipos e usos.
Changelog registra mudanças entre versões. Release notes costumam explicar uma entrega para seu público, incluindo novidades, correções, limitações e instruções relevantes.
SemVer, ou versionamento semântico, utiliza MAJOR.MINOR.PATCH. Em um projeto que segue a especificação SemVer, com API pública definida e estável:
- MAJOR: mudança incompatível na API pública.
- MINOR: funcionalidade adicionada de forma compatível.
- PATCH: correção compatível.
Assim, 1.4.2 não significa simplesmente “mudança grande, média e pequena”. O critério é compatibilidade. Versões 0.x possuem tratamento de desenvolvimento inicial, e nem todo projeto adota SemVer.
Breaking change é uma mudança que quebra uma compatibilidade esperada. Deprecated indica que um recurso deixou de ser recomendado e pode ter uma alternativa ou remoção planejada; ele pode continuar funcionando. Backward compatibility é a capacidade de preservar o uso esperado por consumidores anteriores.
Você também verá alpha, beta e RC — release candidate, identificando estágios de pré-lançamento. O grau de estabilidade depende da política do projeto.
Conventional Commits é uma convenção para mensagens, como feat: adiciona filtro por cidade e fix: corrige exportação CSV. feat comunica funcionalidade; fix, correção. Times também usam docs, test, refactor, chore, build e ci, conforme suas regras. ! ou o rodapé BREAKING CHANGE sinalizam incompatibilidade. A especificação não torna todos esses tipos adicionais obrigatórios.
Refactor / refatoração é reorganizar a estrutura interna preservando o comportamento observável pretendido. Technical debt / dívida técnica é o custo futuro de escolhas e pendências técnicas que tornam a evolução mais difícil. Nem toda mudança de estrutura resolve dívida; explique qual dificuldade será reduzida.
12. Issue, sprint e daily: organizando o trabalho da equipe
O código começa antes do primeiro comando Git: alguém precisa entender o problema e combinar o que será entregue.
| Termo | Significado usual |
|---|---|
| Issue / ticket / card | Registro de uma demanda, problema ou discussão em uma ferramenta de acompanhamento. |
| Bug | Defeito ou comportamento incorreto em relação ao esperado. |
| Feature | Funcionalidade ou capacidade do produto. |
| Task | Tarefa executável. |
| User story | Descrição de uma necessidade sob a perspectiva de quem usa o produto. |
| Epic | Agrupamento maior de trabalho, geralmente dividido em itens menores. |
| Backlog | Conjunto ordenado de trabalho conhecido e possível para o produto ou equipe. |
| Priority | Ordem ou urgência de atendimento. |
| Severity | Gravidade do impacto de um problema. Um defeito grave e uma demanda prioritária não são necessariamente a mesma coisa. |
| Acceptance criteria | Condições específicas para aceitar determinada entrega. |
| Blocker / impedimento | Algo que impede o avanço. |
| Dependency | Trabalho, recurso ou decisão de que outro item depende. |
| Milestone | Marco usado para agrupar entregas ou objetivos. |
| Roadmap | Visão da direção e das iniciativas planejadas, sujeita a revisão. |
Uma issue útil sobre o CSV descreve como reproduzir o erro, o resultado observado e o resultado esperado. “Exportação ruim” deixa quase todo o trabalho de investigação para a próxima pessoa. A introdução a issues do GitHub traz orientações de preenchimento.
Nos times que utilizam Scrum, algumas palavras têm definições próprias:
| Termo | Ideia central |
|---|---|
| Sprint | Ciclo com duração fixa de até um mês. |
| Sprint planning | Planejamento do objetivo e do trabalho da sprint. |
| Daily Scrum / daily | Encontro para inspecionar o progresso rumo à meta da sprint e ajustar o plano; no Scrum, dura 15 minutos. |
| Refinement / refinamento | Atividade contínua para detalhar e ajustar itens do backlog. |
| Sprint review | Inspeção do resultado com interessados e discussão das próximas adaptações. |
| Retrospective / retro | Reflexão sobre como melhorar a forma de trabalhar. |
| Definition of Done / DoD | Definição compartilhada das condições de qualidade para considerar o incremento concluído. |
Esses sentidos vêm do Guia do Scrum. Nem toda reunião chamada daily segue Scrum, e usar Git não obriga ninguém a adotar esse framework.
Story points são uma forma de estimativa relativa adotada por algumas equipes. Não têm conversão universal em horas e não são exigência do Scrum. Kanban é uma abordagem de gestão do fluxo; o quadro de cartões é uma de suas representações. WIP limit limita a quantidade de trabalho em andamento para ajudar o fluxo. A orientação da Atlassian sobre estimativas e o Kanban Guide aprofundam esses conceitos.
Outras expressões úteis: pair programming é programação em dupla; handoff, passagem de responsabilidade ou contexto; onboarding, integração de alguém ao projeto; RFC — request for comments, proposta estruturada para discussão; ADR — architecture decision record, registro de uma decisão arquitetural e de seu contexto. Uma POC — proof of concept, ou prova de conceito, testa a viabilidade de uma ideia; um MVP — minimum viable product, ou produto mínimo viável, é uma versão mínima utilizável para testar uma proposta de valor. Os critérios precisam ser combinados.
Nomes de funções também variam. Tech lead costuma coordenar decisões técnicas; Product Owner responde pela gestão do Product Backlog no Scrum; maintainer cuida da continuidade e das contribuições de um projeto. Ter um cargo específico não concede automaticamente permissão para aprovar ou publicar: isso depende dos acessos e das regras locais.
13. Algumas palavras que aparecem ao preparar o ambiente
Você não precisa decorar toda a infraestrutura para participar do primeiro PR. Mas estes termos costumam surgir nas instruções para rodar o projeto:
| Termo | O que procurar no contexto |
|---|---|
| Stack | Conjunto de tecnologias usado no sistema. |
| Frontend / backend | Camada de interação e camadas de processamento e serviços, conforme a arquitetura. |
| API / endpoint | Interface de comunicação e um ponto específico de acesso a operações ou recursos. |
| Dependency / package | Biblioteca, pacote ou componente utilizado pelo projeto. |
| Package manager | Ferramenta de instalação e gerenciamento de pacotes, como npm ou Composer. |
| Lockfile | Arquivo que registra resoluções de dependências para tornar instalações reproduzíveis dentro do ecossistema. |
| Script | Sequência de comandos para uma tarefa, como testar ou construir o projeto. |
| Environment variable / env var | Valor fornecido ao processo para configurar seu comportamento. |
| Secret | Dado sensível, como senha, token ou chave privada. Uma variável de ambiente pode carregar um secret, mas nem toda variável é secreta. |
| Container | Ambiente de execução isolado para processos e suas dependências. |
| Container image | Modelo empacotado usado para criar containers. |
| Registry | Serviço que armazena e distribui imagens ou pacotes, conforme o contexto. |
| Monorepo / multirepo | Organização de projetos em um repositório compartilhado ou em vários repositórios. |
As referências de package-lock do npm, variáveis de ambiente do Node.js e conceitos de containers do Docker ajudam a reconhecer exemplos concretos.
Se um secret foi compartilhado indevidamente, apagar o arquivo no commit seguinte não basta. Revogue ou rotacione a credencial e trate as cópias e o histórico conforme o incidente. A orientação do GitHub para dados sensíveis começa por essa necessidade.
14. Uma tarefa completa: agora a conversa faz sentido
Vamos juntar tudo em um exemplo fictício: a exportação de CSV corrompe nomes com acento.
- A equipe registra uma issue, com passos para reproduzir o bug e critérios de aceitação.
- Você atualiza sua cópia e cria a branch
fix/exportacao-csva partir da base combinada. - Altera o código, adiciona um teste de regressão e consulta o diff.
- Prepara o conteúdo na staging area e cria um commit com uma mensagem clara.
- Faz push e abre um PR, relacionando a issue e explicando como verificou a correção.
- A pipeline de CI executa as verificações configuradas. Uma colega faz code review.
- Você atende aos comentários e resolve eventuais conflitos. As verificações voltam a rodar conforme a configuração.
- O PR é integrado por merge, squash ou outra estratégia adotada pelo projeto.
- A versão segue pelo processo de entrega: build, deploy em homologação, validação e deploy em produção, quando essas etapas fazem parte do fluxo.
- A equipe acompanha logs e métricas e comunica a release. Se houver problema, avalia correção, desativação por flag ou rollback, considerando também os dados.
Cada equipe adapta esse caminho. Algumas automatizam quase tudo; outras exigem aprovações. Nem todo merge provoca deploy, e nem todo deploy libera uma funcionalidade para todos.
Como uma parte disso aparece no terminal
O exemplo abaixo é didático. Ele pressupõe um repositório já clonado, árvore de trabalho limpa, uma branch main com acompanhamento configurado e permissão de escrita no remoto origin. Os arquivos e a branch são ilustrativos. Se uma etapa falhar, leia o motivo antes de continuar.
git status
git switch main
git pull --ff-only
git switch -c fix/exportacao-csv
# Agora você edita o código e executa os testes do projeto.
git diff
git add src/exportador.js tests/exportador.test.js
git diff --staged
git commit -m "fix: corrige exportação de nomes com acento"
git push -u origin fix/exportacao-csv
O --ff-only pede que a atualização avance sem criar uma integração de históricos divergentes; se isso não for possível, o comando interrompe essa atualização. O -u do push configura o acompanhamento da branch enviada. Nenhum desses comandos abre um PR ou faz deploy por conta própria.
Um tradutor rápido de mensagens do time
| O que você ouviu | O que precisa entender |
|---|---|
| “Já commitei.” | A alteração foi registrada no histórico local. Ainda pode faltar compartilhá-la. |
| “Já subi a branch.” | Provavelmente houve push; confirme qual remoto e branch. |
| “O PR está draft.” | A proposta existe e continua em preparação. |
| “A pipeline quebrou.” | Alguma verificação falhou; consulte o job e seus logs. |
| “Falta um LGTM.” | Falta uma revisão favorável ou aprovação, conforme a regra do time. |
| “Já está na main.” | A mudança chegou à branch principal. Isso não confirma produção. |
| “Está em homolog.” | A versão está no ambiente de homologação. |
| “Já fiz deploy.” | Pergunte a versão e o ambiente se a mensagem não informar. |
| “Vamos dar rollback.” | A equipe pretende retornar um estado implantado; é necessário identificar o alcance e os efeitos. |
Entender o vocabulário ajuda a fazer perguntas melhores
Você não precisa recitar esse glossário para merecer participar de uma equipe. Precisa reconhecer as etapas e conseguir explicar onde seu trabalho está.
“Terminei” pode virar: “O PR está pronto para revisão, os testes passaram e ainda falta validar em homologação”. “Subi” pode virar: “Enviei a branch para o remoto; o deploy ainda não aconteceu”.
Essa precisão evita expectativas diferentes sobre o mesmo trabalho. E, quando alguém usar um termo desconhecido, pergunte: “O que exatamente isso significa neste projeto?” A resposta costuma ser mais útil do que fingir que entendeu.
Referências consultadas na documentação oficial de Git, GitHub, GitLab e das demais ferramentas e especificações citadas, em 7 de novembro de 2026. Os exemplos de tarefas, mensagens e comandos são didáticos; nomes, permissões e processos variam entre projetos.