Prácticas recomendadas para equipos y incorporación

Guía compartida y portable en todas las áreas de especialización.

Estas reglas destilan la guía de incorporación, emparejamiento, revisión, documentación y nivelación de esta sección en hábitos que puede aplicar en tickets, 1:1s y calendarios de ingeniería.

Cómo usar esta lista

• Marque los elementos a medida que su equipo los adopte; utilice las brechas como elementos de acción para retrospectivas.
• Vincule cada regla a un propietario (gerente, compañero o plataforma).
• Revise trimestralmente después de las actualizaciones de la cadena de herramientas o de las cohortes de contratación.
• Empareje con las páginas de sección para obtener el razonamiento y los ejemplos.

A - Incorporación e hitos

• Asigne un compañero designado antes del primer día. La incorporación falla cuando los nuevos empleados adivinan a quién contactar.
• Ejecute la lista de verificación de 30/60/90 con evidencia fechada. Los enlaces de PR fusionados superan las vagas actualizaciones de "en camino".
• Haga coincidir la versión de Go localmente con la de CI desde el primer día. Evita la rotación de la cadena de herramientas en la primera semana.
• Exija el primer PR fusionado en la primera semana. La documentación o las pruebas son válidas; el objetivo es aprender el proceso.
• Utilice bloques de Ruta de Lectura de Go Efectivo, no blogs aleatorios. El orden reduce las brechas en errores y concurrencia.
• Comprima la incorporación para los empleados con experiencia en Go, no en cultura. Las normas del equipo aún necesitan pruebas.

B - Emparejamiento y enseñanza

• Programe sesiones de emparejamiento estructuradas con agendas. 90 minutos con notas de resumen, no compartir pantalla ad hoc.
• Rote al conductor y al navegador cada 20-30 minutos en grupos. Mantiene el compromiso y difunde habilidades.
• Ejecute go test -race en las salidas de emparejamiento de concurrencia. Las pruebas verdes sin carreras son insuficientes.
• Finalice las sesiones con un PR o ticket de seguimiento. El acuerdo verbal sin artefactos se desvanece.
• Rote a los compañeros después del primer mes. Los nuevos empleados absorben múltiples voces de revisión.
• Registre las decisiones, no las sesiones completas, a menos que la política lo permita. El seguimiento escrito respeta la privacidad y a los compañeros asíncronos.

C - Cultura de revisión de código

• Los autores pegan la prueba de CI en las descripciones de PR. Los revisores comienzan con hechos, no con suposiciones.
• Bloquee las carreras, los errores ignorados y las exportaciones que rompen sin aprobación. Los detalles menores ceden ante los linters.
• Enseñe con justificaciones y enlaces a documentación. Comentarios como "no es idiomático" sin el porqué erosionan la confianza.
• Promueva los detalles repetidos a golangci-lint o ADRs. La tercera repetición significa automatización o excepción documentada.
• Exija un segundo revisor en los cambios de concurrencia. El estado mutable compartido merece ojos adicionales.
• Apunte a la primera respuesta de revisión dentro de un día hábil. La latencia detiene silenciosamente la incorporación.

D - Documentación y estándares

• Comente cada símbolo exportado comenzando con su nombre. godoc es la superficie de referencia.
• Mantenga un comentario de paquete por paquete en doc.go o archivo designado. Evite bloques de paquetes duplicados.
• Agregue funciones de ejemplo para bibliotecas consumidas por otros equipos. La documentación ejecutable detecta desviaciones en CI.
• Separe godoc de los runbooks. Los operadores necesitan wikis con enlaces de paginación; godoc contiene los contratos de API.
• Actualice los comentarios cuando cambie el comportamiento. La documentación desactualizada son defectos, no deuda para posponer indefinidamente.
• Dirija a los nuevos empleados a los estándares de codificación y al índice de ADR en la primera semana. Reduce los temas de revisión repetidos.

E - Nivelación y claridad profesional

• Comparta la guía de nivelación durante la retrospectiva de incorporación al día 60. Alinea al nuevo empleado y al gerente en las expectativas.
• Evalúe el alcance y la enseñanza, no las trivialidades de sintaxis, en los niveles superiores. Las señales de promoción son el impacto en múltiples paquetes.
• El impacto del personal se muestra en modismos multiequipo y enseñanza duradera. La heroicidad de un solo proyecto es insuficiente por sí sola.
• La calibración utiliza evidencia a lo largo de los trimestres. Los PRs individuales no constituyen un nivel.
• Los seniors son responsables de las asignaciones de compañeros y la curación de PRs ejemplares. La cultura de revisión escala a través del modelado.

Preguntas frecuentes

Relacionado

• Incorporación de especialistas en Go - modelo de incorporación
• Lista de verificación de incorporación de SME de Go (30/60/90) - partitura del nuevo empleado
• Conceptos básicos de incorporación de equipos - ejemplos ejecutables de la primera semana
• Cultura de revisión de código para Go - normas de revisión en profundidad
• Guía de nivelación: de Junior a Staff en Go - señales de carrera

Versiones de pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, go fix modernizers - verifique el parche en la compilación), chi (última versión - verifique en la compilación), gin (última versión - verifique en la compilación), echo (última versión - verifique en la compilación), google.golang.org/grpc (última versión - verifique en la compilación), sigs.k8s.io/controller-runtime (última versión - verifique en la compilación), kubebuilder (última versión - verifique en la compilación), tinygo (última versión - verifique los objetivos de la placa en la compilación), wazero (última versión - verifique en la compilación) y golangci-lint (última versión - verifique el conjunto de linters en la compilación).