Cómo colaborar

Echidna es un proyecto libre realizado por docentes. En esta página se explica cómo colaborar con o sin cuenta de GitHub, y qué hay en cada repositorio.

El software y los materiales de Echidna Educación son libres, y los diseños de la placa, abiertos para uso no comercial: se pueden usar, estudiar, modificar y compartir (mira las licencias). El proyecto lo hace una comunidad de docentes, y cualquiera puede aportar, sepa o no de programación.

Formas de colaborar

  • Cuenta tu experiencia: cómo has usado Echidna en clase, para publicarla en el blog.
  • Comparte materiales: proyectos, situaciones de aprendizaje, diapositivas o diseños 3D que hayas preparado.
  • Avisa de errores: en esta web, en el manual, en las guías o en EchidnaML.
  • Propón mejoras: ideas para EchidnaML, la placa o los materiales.
  • Traduce: los materiales o el programa a otros idiomas.
  • Da a conocer el proyecto: en tu centro, en cursos o en redes sociales.

Sin cuenta de GitHub

La forma más sencilla es escribirnos desde el formulario de contacto y contarnos qué quieres aportar: una experiencia, un material, un error que has visto… Nosotros nos encargamos de llevarlo al sitio que corresponda.

En GitHub

GitHub es la plataforma donde están el código de EchidnaML, los diseños de la placa, los materiales y esta misma web. Guarda el historial de todos los cambios y permite que cualquiera proponga mejoras, que el equipo revisa antes de aceptarlas. Necesitas una cuenta, que es gratuita.

Avisar de un error o proponer una mejora

Se hace con una issue (incidencia):

  1. Entra en el repositorio que corresponda (están en la lista de abajo).
  2. Abre la pestaña Issues y pulsa New issue.
  3. Ponle un título claro y describe el error o la mejora: dónde lo has visto, qué esperabas y qué ha pasado. Una captura de pantalla ayuda mucho.
  4. Pulsa Create. El equipo te responderá en la misma issue.

Proponer un cambio

Se hace con un pull request (propuesta de cambios), sin instalar nada:

  1. Abre en GitHub el fichero que quieres cambiar y pulsa el lápiz (Edit this file). GitHub crea automáticamente una copia del repositorio en tu cuenta (un fork).
  2. Haz los cambios y escribe debajo un resumen de lo que has cambiado.
  3. Pulsa Propose changes y, en la página siguiente, Create pull request.
  4. El equipo revisa la propuesta, te puede pedir algún ajuste y, cuando está lista, la acepta (merge).

Algunas normas: escribe en castellano, haz una propuesta por cada cambio y ten en cuenta que lo que aportes se publica con la licencia del repositorio.

Repositorios

Web y materiales

Repositorio Qué contiene
EchidnaEducacion.github.io Esta web y su planificación
manual El manual de usuario de la EchidnaBlack2 y EchidnaML
GuiaInicioEchidnaML Proyectos de inicio con EchidnaML
GuiaInicioArduinoIDE Proyectos de inicio con Arduino IDE
situaciones-aprendizaje Situaciones de aprendizaje hechas con eXeLearning
recursos Diseños 3D y materiales de las placas anteriores
Bricks Piezas compatibles con LEGO

EchidnaML

Repositorio Qué contiene
echidnaml El entorno de programación EchidnaML
echidnaml-releases Las versiones publicadas de EchidnaML, para descargar
echidna-scratch-gui, echidna-scratch-vm y echidna-scratch-l10n La interfaz, el motor y las traducciones de Scratch adaptados para EchidnaML
echidna-lml-editor El editor de LearningML que integra EchidnaML

Placa

Repositorio Qué contiene
EchidnaBlack2C_StdFirm El programa StandardFirmata de la EchidnaBlack2
echidna-sensor-test Programa para probar los sensores de la placa
echidna-fab-test Programa para probar las placas al fabricarlas
echidna-firmata-test Prueba de StandardFirmata en la placa desde Chrome
S4A-EchidnaBlack2C Librería para programar la placa con Snap!
  • Escríbenos

    Cuéntanos qué quieres aportar desde el formulario de contacto y te ayudamos a hacerlo.

  • Echidna Educación en GitHub

    Todos los repositorios de la organización, con su código, sus materiales y su historial.