Contribuir

Las contribuciones deben mejorar claridad, trazabilidad, accesibilidad o aplicación pedagógica. El proyecto acepta correcciones pequeñas, contenido desarrollado y revisiones documentadas.

Metodología · Flujo de contenido y despliegue · Estándar de presentación · Estándar de calidad · Roadmap

Antes de comenzar

• Describe el problema y quién se beneficia.
• Identifica nivel, asignatura, OA y clase afectada.
• Usa fuentes primarias para afirmaciones curriculares o normativas.
• No incluyas datos de estudiantes ni material de terceros sin permiso verificable.
• Conserva los identificadores existentes salvo que exista un error demostrado.

Contrato de una clase desarrollada

Toda clase debe incluir:

1. identificador, posición, nivel, asignatura y OA;
2. propósito docente y meta en lenguaje estudiantil;
3. conocimientos previos, vocabulario y error previsible;
4. inicio, modelado, práctica guiada y desempeño individual;
5. materiales y preparación viables;
6. apoyo que conserva el OA y profundización no mecánica;
7. ticket, evidencia y al menos tres criterios observables;
8. decisión posterior y adaptación a 45 minutos;
9. accesibilidad, seguridad y fuentes pertinentes.

Evita frases intercambiables entre asignaturas. Una clase debe nombrar el contenido, el producto o desempeño, el razonamiento que se modela y la evidencia que se observará.

Reglas editoriales

• Usa clase, no “sesión”, para las unidades de enseñanza del proyecto.
• Distingue texto oficial, interpretación editorial y sugerencia docente.
• No declares “revisada” una clase sin registrar evidencia humana.
• No presentes lecturas asociadas como obligatorias.
• Ofrece alternativas sin conectividad cuando la actividad dependa de tecnología.
• Mantén el OA al proponer apoyos; modifica el acceso, no la expectativa central.
• Profundiza mediante explicación, comparación o transferencia, no con más repetición.
• Registra todo cambio visible para usuarios en la primera entrada fechada de CHANGELOG.md; el generador lo publicará automáticamente en “Novedades” y CI rechazará una vista desactualizada.
• En Markdown, enlaza la representación Markdown del documento; en HTML, enlaza su representación HTML. El portal público raíz es el único punto de entrada web permitido desde Markdown. No enlaces una página HTML secundaria para evitar documentar su fuente canónica.
• No edites archivos PDF: se regeneran únicamente desde las fuentes Markdown canónicas.

Fuente y artefactos generados

Modifica la fuente estructurada correspondiente. No edites manualmente miles de fichas derivadas: scripts/generate_school_program.py vuelve a producir catálogo, Markdown, HTML, malla, sitemap, portada documental, índices y 149 guías completas de 1° básico a 4° medio. Para competencias, edita los JSON versionados y regenera su vista con scripts/generate_competency_portal.py.

Después del cambio ejecuta:

python scripts/generate_school_program.py
python scripts/generate_competency_portal.py
python scripts/validate_school_program.py
python scripts/validate_licensing.py
python scripts/validate_competency_system.py
python scripts/validate_content_presentation.py
python scripts/generate_competency_portal.py --check
python -m unittest discover -s tests -p "test_*.py" -v

El diff después de una segunda generación debe quedar vacío.

Revisión propuesta

Una revisión humana debe indicar:

• persona o rol revisor;
• fecha;
• alcance: disciplina, pedagogía, accesibilidad, documentación o derechos;
• OA y clases revisadas;
• hallazgos y cambios realizados;
• aspectos que siguen pendientes.

El equipo mantenedor decide cuándo la evidencia permite cambiar el estado editorial.

Derechos y procedencia

Registra contenido externo y atribuciones según LICENSING.md. Enlaza recursos cuando la licencia no permite redistribución y no copies fragmentos extensos de obras.

Al contribuir confirmas que puedes enviar el aporte y concederlo bajo la licencia que corresponde:

• código original → MIT;
• contenido educativo original → CC BY-NC-SA 4.0;
• material de terceros → solo con licencia, atribución y permiso de redistribución comprobables.

No se exige un CLA. El proyecto adopta el Developer Certificate of Origin 1.1 como declaración ligera de procedencia para contribuciones futuras. Firma cada commit con:

Signed-off-by: Nombre Apellido <correo@example.com>

La firma confirma que tienes derecho a enviar el aporte, que conoces su carácter público y que su registro puede conservarse. No transfiere la titularidad ni permite relicenciar obras ajenas. Los commits anteriores a la adopción documentada en el historial de licenciamiento no se consideran firmados retroactivamente.