Plantilla de Código de Conducta
Plantilla de código de conducta comunitaria para establecer estándares de colaboración inclusivos y respetuosos.
Resumen
Un código de conducta establece expectativas sobre el comportamiento de los participantes dentro de una comunidad. Crea un ambiente acogedor y provee procedimientos para abordar violaciones. Sin uno, los mantenedores no tienen marco para manejar comportamiento novedoso, y los colaboradores no saben qué esperar.
Cuándo Usar
- Manejas un proyecto open-source con colaboradores externos
- Quieres construir una comunidad inclusiva
- Tu organización requiere estándares de comportamiento explícitos
Plantilla
# Código de Conducta
## Nuestro Compromiso
Como miembros, colaboradores y líderes, nos comprometemos a hacer de la
participación en nuestra comunidad una experiencia libre de acoso para todos,
independientemente de la edad, tamaño corporal, discapacidad visible o invisible,
etnicidad, características sexuales, identidad y expresión de género, nivel de
experiencia, educación, situación socioeconómica, nacionalidad, apariencia
personal, raza, religión, o identidad y orientación sexual.
## Nuestros Estándares
### Comportamiento Positivo
- Usar lenguaje acogedor e inclusivo
- Respetar diferentes puntos de vista y experiencias
- Aceptar críticas constructivas con gracia
- Enfocarse en lo que es mejor para la comunidad
- Mostrar empatía hacia otros miembros de la comunidad
### Comportamiento Inaceptable
- El uso de lenguaje o imágenes sexualizadas
- Trolleo, comentarios insultantes/despectivos y ataques personales
- Acoso público o privado
- Publicar información privada de otros sin permiso
- Otra conducta que razonablemente podría considerarse inapropiada
## Responsabilidades de Cumplimiento
Los líderes de la comunidad son responsables de clarificar y hacer cumplir los
estándares de comportamiento aceptable y tomarán acciones correctivas apropiadas
y justas en respuesta a cualquier comportamiento inapropiado, amenazante,
ofensivo o dañino.
## Alcance
Este Código de Conducta aplica dentro de todos los espacios de la comunidad y
también cuando un individuo representa oficialmente a la comunidad en espacios
públicos.
## Cumplimiento
Los casos de comportamiento abusivo, acosador o inaceptable pueden ser reportados
a los líderes de la comunidad responsables del cumplimiento en [email].
Todas las quejas serán revisadas e investigadas de manera pronta y justa.
## Atribución
Este Código de Conducta está adaptado del [Contributor Covenant](https://www.contributor-covenant.org),
versión 2.1.
Secciones Clave
| Sección | Propósito |
|---|---|
| Compromiso | Compromiso de la comunidad con la inclusión |
| Estándares | Comportamientos positivos y negativos explícitos |
| Cumplimiento | Quién maneja violaciones y cómo |
| Alcance | Dónde aplica el código |
| Reporte | Cómo reportar violaciones |
Niveles de Cumplimiento
| Nivel | Comportamiento | Acción |
|---|---|---|
| 1. Advertencia | Primera violación menor | Mensaje privado de los mantenedores |
| 2. Ban temporal | Violaciones repetidas o incidente serio | Remoción de espacios de comunidad por 1-30 días |
| 3. Ban permanente | Violación severa o bans temporales repetidos | Remoción permanente de todos los espacios de comunidad |
| 4. Referencia legal | Amenazas, doxxing o conducta ilegal | Reportar a autoridades, preservar evidencia |
Ejemplo Completo
# Código de Conducta
## Nuestro Compromiso
Como miembros, colaboradores y líderes, nos comprometemos a hacer de la
participación en nuestra comunidad una experiencia libre de acoso para todos,
independientemente de la edad, tamaño corporal, discapacidad visible o invisible,
etnicidad, características sexuales, identidad y expresión de género, nivel de
experiencia, educación, situación socioeconómica, nacionalidad, apariencia
personal, raza, religión, o identidad y orientación sexual.
Nos comprometemos a actuar e interactuar de formas que contribuyan a una
comunidad abierta, acogedora, diversa, inclusiva y saludable.
## Nuestros Estándares
### Comportamiento Positivo
- Usar lenguaje acogedor e inclusivo
- Respetar diferentes puntos de vista y experiencias
- Aceptar críticas constructivas con gracia
- Enfocarse en lo que es mejor para la comunidad
- Mostrar empatía hacia otros miembros de la comunidad
### Comportamiento Inaceptable
- El uso de lenguaje o imágenes sexualizadas
- Trolleo, comentarios insultantes/despectivos y ataques personales
- Acoso público o privado
- Publicar información privada de otros sin permiso
- Otra conducta que razonablemente podría considerarse inapropiada
## Responsabilidades de Cumplimiento
Los líderes de la comunidad son responsables de clarificar y hacer cumplir los
estándares de comportamiento aceptable y tomarán acciones correctivas apropiadas
y justas en respuesta a cualquier comportamiento inapropiado, amenazante,
ofensivo o dañino.
Los líderes de la comunidad tienen el derecho y la responsabilidad de remover,
editar o rechazar comentarios, commits, código, wiki edits, issues y otras
contribuciones que no estén alineadas con este Código de Conducta.
## Alcance
Este Código de Conducta aplica dentro de todos los espacios de la comunidad,
incluyendo repositorios de GitHub, servidor de Discord, mailing lists y stands
de conferencias. También aplica cuando un individuo representa oficialmente a
la comunidad en espacios públicos, como hablar en eventos o publicar en cuentas
oficiales de redes sociales.
## Cumplimiento
Los casos de comportamiento abusivo, acosador o inaceptable pueden ser reportados
a los líderes de la comunidad responsables del cumplimiento en
conduct@example.com. Todas las quejas serán revisadas e investigadas de manera
pronta y justa.
Todos los líderes de la comunidad están obligados a respetar la privacidad y
seguridad del reportero de cualquier incidente.
## Guías de Cumplimiento
1. **Corrección**: Advertencia escrita privada de los mantenedores clarificando la violación
2. **Advertencia**: Advertencia con consecuencias por comportamiento continuado, sin interacción pública por 3 días
3. **Ban Temporal**: Prohibido de interacción comunitaria por 1-30 días
4. **Ban Permanente**: Ban permanente de todos los espacios de la comunidad
## Atribución
Este Código de Conducta está adaptado del [Contributor Covenant](https://www.contributor-covenant.org),
versión 2.1, disponible en https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
Lo que funciona
- Adapta, no copies: Personaliza la plantilla a las necesidades de tu comunidad
- Hazlo visible: Enlaza prominentemente en el README y repositorio
- Cumple consistentemente: Un código sin cumplimiento no tiene sentido
- Revisa anualmente: Actualiza a medida que tu comunidad evoluciona
- Provee un canal de reporte privado: email o DM, no issues públicos
- Documenta acciones de cumplimiento: mantén un log privado para consistencia
- Entrena moderadores: asegúrate de que entiendan la escalada
Errores Comunes
- Copiar el Contributor Covenant sin leerlo — entiende qué estás adoptando
- Sin mecanismo de reporte — un código sin canal de reporte es incumplible
- Cumplimiento inconsistente — aplicar reglas a algunos pero no a otros destruye confianza
- Sin definición de alcance — los colaboradores no saben dónde aplica el código
- Discusiones de cumplimiento públicas — las violaciones deben manejarse privadamente
Comparacion de Variantes
| Variante | Contexto | Enfoque | Notas |
|---|---|---|---|
| Contributor Covenant 2.1 | Proyecto open-source, comunidad general | Compromiso + estandares + cumplimiento | Mas comun; ampliamente reconocido |
| Codigo corporativo | Proyecto interno de empresa | Agregar referencia HR, asignacion IP, NDA | Alinea con handbook de empleados |
| Codigo de evento | Conferencia o meetup | Agregar fotografias, alcohol, accesibilidad | Incluir telefono en sitio |
| Codigo simplificado | Proyecto pequeno (1-2 mantenedores) | Compromiso + 5 positivos + 5 negativos + email | Omitir niveles de cumplimiento |
Escenario Detallado: Aplicar una Violacion del Codigo de Conducta
Incidente: Un colaborador publica comentarios despectivos sobre la
calidad del codigo de otro colaborador en un issue publico de GitHub.
Paso 1 - Triaje (dentro de 24 horas):
- El equipo de moderacion revisa el thread del issue
- Dos moderadores coinciden: esto es una violacion Nivel 1
- Un moderador se asigna como responsable del caso
Paso 2 - Accion (dentro de 48 horas):
- El responsable envia un mensaje privado al infractor:
"Tu comentario en el issue #142 viola nuestro Codigo de Conducta.
Especificamente, el lenguaje usado es despectivo y personal.
Por favor revisa nuestros estandares en [link]. Esta es una
advertencia formal. Violaciones repetidas resultaran en ban temporal."
- El responsable envia un mensaje privado al colaborador afectado:
"Vimos el comentario en el issue #142 y lo hemos abordado.
No deberias lidiar con ataques personales aqui.
Avisanos si hay mas incidentes."
- El comentario infractor se edita o se oculta (no se elimina)
Paso 3 - Documentacion:
- Registrar el incidente en el log privado de moderacion:
Fecha, numero de issue, infractor, accion tomada, responsable
- Agendar revision del comportamiento del infractor en 30 dias
Paso 4 - Escalacion (si se repite):
- Segunda violacion dentro de 90 dias -> Nivel 2 (ban temporal)
- Enviar notificacion privada con duracion y condiciones del ban
- Remover de organizacion de GitHub, Discord, mailing lists
- Documentar la escalacion en el log de moderacion
Paso 5 - Readmision:
- Despues del periodo de ban, revisar el caso
- Si el colaborador reconoce la violacion y se compromete
con el codigo, readmitir con nota en el log
- Tercera violacion -> ban permanente, sin readmision
Como manejo reportes anonimos?
Acepta reportes via un formulario anonimo (ej: Google Forms, Typeform) enlazado desde la pagina del Codigo de Conducta. Los reportes anonimos son mas dificiles de investigar pero deben revisarse igualmente. Acusa recibo si se provee informacion de contacto. No descartes reportes anonimos: patrones de reportes anonimos sobre la misma persona indican un problema real.
Que pasa si la violacion ocurre fuera de los espacios de la comunidad?
El codigo aplica cuando alguien representa a la comunidad (ej: habla en una conferencia, publica en el Twitter oficial del proyecto). Para comportamiento en espacios puramente personales, el codigo no aplica directamente. Sin embargo, si el comportamiento personal de un miembro hace que otros se sientan inseguros en la comunidad, el equipo de moderacion puede actuar. Usa juicio y documenta el razonamiento.
Variantes
Código de conducta corporativo
Para proyectos corporativos, agrega secciones para referencia de HR, compliance legal y consecuencias específicas para empleados. Referencia políticas internas y handbooks de empleados. Los códigos corporativos pueden incluir NDAs y asignación de IP además de estándares de comportamiento.
Código de conducta para eventos
Para conferencias y meetups, agrega secciones para reglas específicas del evento: políticas de fotografía, guías de alcohol, adaptaciones de accesibilidad e información de contacto en sitio. Incluye un número de teléfono para reportes inmediatos durante eventos.
Código simplificado para proyectos pequeños
Para proyectos pequeños con 1-2 mantenedores, usa una versión simplificada: compromiso, 5 comportamientos positivos, 5 inaceptables, y un email de reporte. Omite niveles de cumplimiento — el mantenedor maneja cada caso individualmente.
Lectura Adicional
- Documentación oficial: consulta la referencia actualizada del framework o herramienta utilizada.
- Guías relacionadas: explora las guías de automation y ci-cd para profundizar.
- Patrones complementarios: revisa los patrones de diseño aplicables a tu stack tecnológico.
- Postmortems públicos: estudia incidentes reales de equipos que enfrentaron problemas similares en producción.
Notas de Producción
- Despliega gradualmente usando canary o blue-green para detectar regresiones temprano.
- Configura alertas para errores, latencia p99 y tasa de fallos antes de habilitar en producción.
- Documenta el rollback en el runbook; prueba el procedimiento en staging al menos una vez por trimestre.
- Revisa logs estructurados con correlation IDs para trazar requests end-to-end en incidentes.
Puntos Clave
- Aplica plantilla de código de conducta cuando necesites una solución práctica para tu caso de uso.
- Monitorea el rendimiento después de implementar; mide latencia, errores y uso de recursos antes y después.
- Revisa la sección de Troubleshooting ante errores comunes; la mayoría tienen causa raíz documentada con solución.
- Mantén dependencias actualizadas y ejecuta tests en CI para prevenir regresiones en producción.
Troubleshooting
- Pipeline fails silently: enable verbose logging and store pipeline artifacts between stages so you can inspect the exact state that failed.
- Container crashes on startup: check that environment variables, secrets, and config files are mounted correctly. Read the first 50 lines of logs before scaling replicas.
- Deployment rolls back repeatedly: verify health checks, resource limits, and startup probes. A failing readiness probe is a common cause of rolling restarts.
- Slow CI builds: cache dependencies and docker layers. Split large test suites into parallel jobs to reduce wall-clock time.
- Drift between environments: use infrastructure-as-code and immutable artifacts.
Errores Comunes en Producción
- Dejar campos requeridos vacíos o usar respuestas vagas de una palabra.
- Llenar el documento una vez y nunca actualizarlo cuando cambia el alcance o las decisiones.
- Guardar el documento donde el equipo no lo busque durante incidentes o revisiones.
- No asignar un responsable, fecha límite o cadencia de revisión.
- Copiar texto base sin eliminar secciones que no aplican.
- Saltar el control de versiones, lo que impide rollback y responsabilidad.
- No vincular el documento con decisiones relacionadas o acciones de seguimiento.
- Evitar revisiones trimestrales que retirarían secciones obsoletas o sin uso.
Preguntas frecuentes
Es un código de conducta legalmente vinculante?
Un código de conducta no es un contrato legal, pero establece estándares comunitarios exigibles. Las violaciones pueden resultar en la expulsión de la comunidad, pero no reemplaza la acción legal por comportamiento ilegal.
Los proyectos pequeños deberían tener un código de conducta?
Sí. Incluso los proyectos pequeños se benefician de expectativas claras. Combínalo con una Guía de Contribución y README para establecer expectativas desde el inicio. Previene malentendidos y crea un ambiente acogedor para nuevos colaboradores de diversos orígenes.
Qué sucede cuando alguien viola el código de conducta?
El equipo de cumplimiento investiga los reportes rápidamente y justamente. Las consecuencias van desde una advertencia hasta la remoción temporal o permanente de la comunidad, dependiendo de la gravedad y recurrencia.
Quién debería estar en el equipo de cumplimiento?
Personas confiables, imparciales y disponibles. Para proyectos pequeños, el mantenedor maneja el cumplimiento. Para proyectos más grandes, forma un comité de 3-5 personas de diferentes equipos o backgrounds. Evita que todos los miembros del equipo sean de la misma empresa o grupo social.
Cómo manejo un reporte contra un mantenedor?
Recusa al mantenedor acusado de la investigación. Si todo el equipo de moderación está implicado, trae un mediador externo. Documenta el proceso y el resultado. La transparencia sobre el proceso (no los detalles) genera confianza.
Los reportes deberían ser públicos o privados?
Privados. Los reportes deben manejarse confidencialmente para proteger tanto al reportero como al acusado. Los reportes públicos desincentivan el reporte y pueden llevar a comportamiento de turba. Publica estadísticas agregadas (número de reportes, acciones tomadas) periódicamente para transparencia.
Recursos Relacionados
Plantilla de Guía de Contribución
Una plantilla lista para usar con directrices de contribución para proyectos open-source e internos.
DocPlantilla README
Una plantilla README lista para producción para proyectos open-source e internos.
GuideGuía de Arquitectura de Software
Una guía para diseñar arquitectura de software: monolitos vs microservicios, arquitectura en capas, flujo de datos y criterios de selección de tecnología.
RecipeConfigura pre-commit hooks con husky y lint-staged
Configura pre-commit hooks con husky, lint-staged y el framework pre-commit. Detectá problemas de lint, formato y seguridad antes de cada commit.