Melhores Práticas de Equipe
Vinte práticas que mantêm equipes Rust rápidas, alinhadas e gentis com futuros contratados.
-
Tempo para o primeiro PR abaixo de cinco dias: Meça o onboarding; corrija bloqueadores de tooling imediatamente.
-
Sistema de colega na primeira semana: Check-in diário de 15 minutos, não canal passivo no Slack.
-
Pin único de toolchain:
rust-toolchain.tomlcorresponde ao MSRV da CI 1.97.0. -
Documento de onboarding no repositório:
docs/onboarding.mdé o canônico, não apenas wiki. -
Checklist de toolchain concluído no dia 1: Antes de atribuir trabalho de funcionalidade.
-
Diagrama de orientação da base de código: Cada novo contratado desenha o fluxo de requisição; o colega valida.
-
Documento de convenções linkado no template de PR: Reduz comentários repetidos de estilo.
-
Checklist de revisão para correção:
unsafe,unwrap, bloqueio de async, injeção de SQL. -
CI espelha hooks locais: fmt, clippy
-D warnings, test, build com--locked. -
Primeiro PR mesclado pequeno: Prova que o pipeline funciona para este humano.
-
Registre lacunas de onboarding como PRs de documentação: Correções na mesma semana para o próximo contratado.
-
ADR para escolhas de plataforma Rust: Tokio, sqlx, estratégia de erro, layout de workspace.
-
Crate/docs de
rust-rulesou regras da equipe: Codifique comentários de revisão repetidos. -
Sprint trimestral de higiene de dependências:
cargo update, avisos, política de negação. -
Aprendizados de incidentes atualizam cookbooks: Link do postmortem para páginas de solução de problemas.
-
Habilidades de agente documentadas: Quando invocar habilidades de revisão de Axum, async, unsafe.
-
Sem heroísmo de plantão: Runbooks no repositório; acompanhe antes da rotação solo.
-
Processo explícito de aumento de MSRV: RFC ou ticket com impacto na CI e nos consumidores.
-
Celebre refatorações que deletam código: LOC negativo é uma vitória da equipe.
-
Retroceda o onboarding após cada contratação: Atualize checklists dentro de uma semana.
FAQs
Qual o tamanho ideal da equipe antes de ADRs?
Dois engenheiros mais uma contratação planejada justificam ADRs leves.
Rituais remotos-first?
Caminhadas de arquitetura gravadas, padrões escritos, SLAs de revisão amigáveis a assíncrono.
Relacionado
- Checklist de Onboarding de Desenvolvedores
- Diretrizes de revisão de código
- Convenções e guia de estilo
- Melhores práticas de Git
Versões de Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.