🤝 Contribuir

Gracias por el interés. Este programa mejora con correcciones de contenido, fuentes adicionales, adaptaciones por país y traducciones.

Antes de contribuir, lee docs/etica-y-limitaciones.md. Define qué es este material y qué obligaciones asume quien lo edita.

✅ Qué se acepta

🤝 Antes de abrir una propuesta

python tools/validate_program.py
python tools/render_program.py --check
python tools/build_syllabus.py --check
python tools/progress.py --check
python tools/build_file_index.py --check
python tools/validate_metadata.py
python scripts/verify_sources.py
python tools/validate_openapi.py
python tools/validate_datasets.py
python tools/detect_secrets.py
python tools/detect_pii.py
python tools/check_links.py
pytest -q
npx markdownlint-cli2

Los catorce deben pasar. Es lo mismo que verifica la integración continua.

Si tocas el portal de estudio, verifica además que se genere:

pip install -r requirements-site.txt && python tools/build_site.py --check

Si tu cambio afecta a una clase, ejecuta el renderizador antes de confirmar:

python tools/render_program.py

Y si añades o quitas clases:

python tools/build_syllabus.py && python tools/progress.py

🧩 Convención de una clase

La validación exige que toda clase contenga estas once secciones:

## 🎯 Propósito
## 📚 Objetivos
## ⚙️ Agenda de 90 minutos          ← generada por render_program.py
## 🧩 Conceptos centrales
## 📖 Desarrollo
## 🧮 Ejemplo guiado
## 🏦 Del cliente al banco
## ⚠️ Errores frecuentes
## ❓ Preguntas de comprobación
## 📥 Entregable
## 📗 Fuentes y verificación

Además:

Adicional para la Etapa 5 (parte ≥ 17)

Las clases de finanzas digitales llevan además un encabezado regulatorio y cinco secciones más. validate_metadata.py las exige:

Usa listas en línea ([global, chile]) en el encabezado: el renderizador reconstruye el YAML clave a clave y una lista multilínea se perdería.

Secciones recomendadas

🧠 Modelo mental y 🧪 Práctica no son obligatorias en las Partes 1 a 16, y todas las clases del programa las incluyen porque sostienen su estructura pedagógica.

Lo que no se edita a mano

Los bloques entre <!-- gen:*:start --> y <!-- gen:*:end --> los genera tools/render_program.py. Si los editas, el siguiente renderizado los sobrescribirá.

✍️ Estilo del contenido

📗 Fuentes

Toda afirmación técnica necesita respaldo. Se aceptan:

• Manuales universitarios de referencia, con autor, año, edición y capítulo.
• Normas contables emitidas (NIIF/NIC) y sus documentos oficiales.
• Documentos de organismos de estándares: BIS, FSB, GAFI, IOSCO, CPMI, OCDE, FMI, Banco Mundial, NIST, ISO, IADI, IAIS.
• Artículos académicos identificables, con revista, volumen y año.

No se aceptan blogs, resúmenes, contenidos sin autoría, ni referencias a «la práctica del sector» sin documento que la sustente.

Formato de una entrada:

- Saunders, A. y Cornett, M. (2021). *Financial Institutions Management* (10.ª ed.).
  McGraw-Hill. Capítulos 8, 9 y 17: gestión de activos y pasivos y de liquidez.
- Basel Committee on Banking Supervision (2016). *Interest rate risk in the banking book*.
  BIS. Escenarios de choque de tasas y medidas de valor económico y margen.
  <https://www.bis.org/bcbs/publ/d368.htm>
- Verificación local: revisa los requerimientos que aplica tu supervisor.

La frase que sigue a la editorial no es opcional: dice qué toma esa clase de esa obra. Sin ella, quien quiera comprobar la afirmación tendría que leerse el documento entero para averiguar si dice lo que la clase supone, y verify_sources.py rechaza la cita.

El registro de fuentes

Las citas no viven solo en la clase: alimentan sources/bibliography.json, donde cada obra tiene emisor, localizador y fecha de comprobación. No se edita a mano — se reconstruye desde las clases:

python scripts/verify_sources.py --rebuild

Un localizador admite exactamente tres formas: ISBN-13 para un libro, DOI para un artículo y URL https de la fuente primaria para una norma o documento oficial. Los resuelve scripts/refresh_sources.py contra Open Library, Crossref y el propio sitio del emisor; lo que no resuelve queda como pendiente con el motivo escrito.

Nunca inventes un ISBN, un DOI, una URL o una fecha, y nunca borres una fuente que no resuelva: se marca, no se elimina. Un hueco declarado es información; un hueco relleno por intuición es una invención con formato de bibliografía.

🌎 Adaptaciones por país

Las ediciones locales son bienvenidas y no sustituyen el contenido internacional.

• Añade una sección al final de la clase; no modifiques la existente.
• Cita la norma nacional con su identificador y su fecha de vigencia.
• Registra la fecha de revisión de la adaptación.
• Ver ROADMAP.md para las ediciones previstas.

🤝 Flujo de trabajo

1. Abre un issue describiendo el cambio, salvo que sea trivial.
2. Crea una rama por cambio: fix/parte-11-clase-04-fuente, docs/glosario.
3. Haz el cambio siguiendo las convenciones de arriba.
4. Ejecuta las siete verificaciones.
5. Abre la propuesta describiendo qué cambia, por qué y qué fuente lo respalda.

Mensajes de confirmación

Corrige la LGD de la clase 8 de la Parte 16

El calculo original omitia el descuento por el plazo de recuperacion.
Fuente: Caouette et al. (2008), capitulo 12.

Imperativo, con el porqué y la fuente cuando corresponda.

🔧 Herramientas y dependencias

📣 Reportar sin contribuir código

🤗 Código de conducta

Este proyecto se rige por su Código de Conducta. Participar implica aceptarlo.

Ver también: README · Documentación · Ética y limitaciones