Melhores Práticas de Equipe e Onboarding

Orientação compartilhada e portátil entre trilhas de SME.

Estas regras destilam o onboarding, pareamento, revisão, documentação e orientação de nivelamento nesta seção em hábitos que você pode impor em tickets, 1:1s e calendários de engenharia.

Como Usar Esta Lista

• Marque os itens à medida que sua equipe os adota; use lacunas como itens de ação de retrospectiva.
• Vincule cada regra a um proprietário (gerente, colega ou plataforma).
• Revise trimestralmente após atualizações da toolchain ou coortes de contratação.
• Pareie com as páginas da seção para obter justificativas e exemplos.

A - Rampa e marcos

• Atribua um colega nomeado antes do primeiro dia. A rampa falha quando os contratados adivinham quem contatar.
• Execute a lista de verificação 30/60/90 com evidências datadas. Links de PR mesclados superam atualizações vagas de "no caminho".
• Combine a versão do Go localmente com a CI no primeiro dia. Evita rotatividade da toolchain na primeira semana.
• Exija o primeiro PR mesclado na primeira semana. Documentos ou testes são válidos; o aprendizado do processo é o objetivo.
• Use blocos do Caminho de Leitura Efetiva do Go, não blogs aleatórios. A ordem reduz lacunas em erros e concorrência.
• Comprima a rampa para contratados experientes em Go, não em cultura. Normas da equipe ainda precisam de prova.

B - Pareamento e ensino

• Agende sessões de pareamento estruturadas com agendas. 90 minutos com notas de debriefing, não compartilhamento de tela ad hoc.
• Rotacione motorista e navegador a cada 20-30 minutos em mobs. Mantém o engajamento e espalha habilidades.
• Execute go test -race nas saídas de pareamento de concorrência. Testes verdes sem race são insuficientes.
• Termine as sessões com um PR ou ticket de acompanhamento. Acordos verbais sem artefatos desaparecem.
• Rotacione colegas após o primeiro mês. Contratados absorvem múltiplas vozes de revisão.
• Registre decisões, não sessões completas, a menos que a política permita. Acompanhamento escrito respeita a privacidade e colegas assíncronos.

C - Cultura de revisão de código

• Autores colam prova de CI nas descrições de PR. Revisores começam com fatos, não suposições.
• Bloqueie em races, erros ignorados e exports quebrados não aprovados. Nits de gosto cedem a linters.
• Ensine com justificativas e links de documentação. Comentários como "não idiomático" sem o porquê corroem a confiança.
• Promova nits repetidos para golangci-lint ou ADRs. Terceira repetição significa automação ou exceção documentada.
• Exija um segundo revisor em mudanças de concorrência. Estado mutável compartilhado merece olhos extras.
• Mire a primeira resposta de revisão dentro de um dia útil. Latência atrasa silenciosamente as rampas.

D - Documentação e padrões

• Comente cada símbolo exportado começando com seu nome. godoc é a superfície de referência.
• Mantenha um comentário de pacote por pacote em doc.go ou arquivo designado. Evite blocos de pacote duplicados.
• Adicione funções de Exemplo para bibliotecas consumidas por outras equipes. Documentos executáveis capturam desvios em CI.
• Separe godoc de runbooks. Operadores precisam de wikis com links de paginação; godoc contém contratos de API.
• Atualize comentários quando o comportamento mudar. Documentos desatualizados são defeitos, não dívidas para adiar para sempre.
• Indique aos contratados os padrões de codificação e o índice de ADRs na primeira semana. Reduz temas de revisão repetidos.

E - Nivelamento e clareza de carreira

• Compartilhe o guia de nivelamento durante a retrospectiva de onboarding no dia 60. Alinha o contratado e o gerente sobre as expectativas.
• Avalie o escopo e o ensino, não trivialidades de sintaxe, em bandas seniores. Sinais de promoção são impacto multi-pacote.
• O impacto da equipe mostra em idiomas multi-equipe e ensino durável. Heroísmo de um único projeto é insuficiente sozinho.
• A calibração usa evidências ao longo de trimestres. PRs únicos não fazem um nível.
• Seniores são donos de atribuições de colegas e curadoria de PRs exemplares. A cultura de revisão escala através da modelagem.

FAQs

Relacionado

• Onboarding de Especialistas Go - modelo de rampa
• Lista de Verificação de Onboarding de SME Go (30/60/90) - placar do contratado
• Noções Básicas de Onboarding de Equipe - exemplos executáveis da primeira semana
• Cultura de Revisão de Código para Go - normas de revisão em profundidade
• Guia de Nivelamento: Júnior a Staff em Go - sinais de carreira

Versões de Stack: Esta página foi escrita para Go 1.26.x (Green Tea GC padrão, go fix modernizers - verifique o patch na compilação), chi (última versão - verifique na compilação), gin (última versão - verifique na compilação), echo (última versão - verifique na compilação), google.golang.org/grpc (última versão - verifique na compilação), sigs.k8s.io/controller-runtime (última versão - verifique na compilação), kubebuilder (última versão - verifique na compilação), tinygo (última versão - verifique os alvos de placa na compilação), wazero (última versão - verifique na compilação) e golangci-lint (última versão - verifique o conjunto de linters na compilação).