v0.67.0 Proyecto nuevo · — desde la primera línea de código Código abierto: colabore en GitHub
Enviar un aporte

JUGADOR 2 · SU PRIMER APORTE

Su primer aporte a un proyecto abierto. Sin saber Git.

Si arma cosas con IA, ya sabe lo suficiente para mejorar Atalaya. Descargue el proyecto, cambie algo pequeño con ayuda de su asistente y súbalo. Nosotros lo revisamos con calma, le contamos cómo va y, si se publica, su nombre queda en los créditos del proyecto y de este sitio.

NIVEL 01LOS PASOS

Cuatro pasos, de principio a fin.

  1. Descargue el proyecto. Entre a github.com/neracosu/atalayams, pulse el botón verde Code y luego Download ZIP. Descomprima el archivo en una carpeta que encuentre fácil.
  2. Ábralo en su editor. VS Code, Cursor o el que use. Si tiene un asistente de IA, este es el momento de pedirle ayuda: más abajo tiene las instrucciones listas para copiar.
  3. Haga un cambio pequeño y véalo. Elija una misión. Si toca el sitio, puede verlo en su computadora con Node instalado: node scripts/export-site.js sitio arma la carpeta sitio, y la abre con un servidor local (su IA le dice cómo en su sistema).
  4. Súbalo. Comprima la carpeta del proyecto en un .zip (clic derecho › Comprimir; si puede, sin node_modules) y súbalo en nube.neracosu.com/aportes con su nombre para los créditos y una línea de qué cambió.

Después le escribimos por correo o WhatsApp para contarle cómo va, aunque la respuesta sea «todavía no, pero casi». ¿Ya sabe Git? Abra un pull request y listo.

NIVEL 02CON SU ASISTENTE DE IA

Copie, pegue y que su IA le acompañe.

Con la carpeta abierta en Claude Code, Cursor o el asistente que use, pegue alguna de estas instrucciones y cambie lo que está entre corchetes.

Para hacer el cambio
Estoy aportando a Atalaya Monitor Server, un proyecto de código abierto (esta carpeta). Quiero [describa su cambio]. Dime qué archivo tengo que tocar y por qué, haz el cambio más pequeño posible y no cambies nada más.
Para ver el sitio en su computadora
En esta carpeta está el proyecto Atalaya. Ayúdame paso a paso a ver el sitio en mi computadora: hay que correr "node scripts/export-site.js sitio" y abrir la carpeta "sitio" con un servidor local. Estoy en [Windows / macOS / Linux] y no sé usar la terminal.
Antes de enviarlo
Revisa mi cambio en este proyecto: corre "npm test" y dime si algo falla. Después hazme un resumen de una línea, en español, de lo que cambié, para ponerlo al enviar mi aporte.
NIVEL 03MISIONES PARA EMPEZAR

¿No sabe qué cambiar? Elija una misión.

Tareas reales que hacen falta, ordenadas por dificultad. Empiece por una chica: el primer aporte es el más importante.

  1. NIVEL 1

    Pruebe el sitio en su celular y cuéntenos

    Recorra neracosu.com/atalaya en su teléfono y anote lo que se ve mal o no se entiende. No hace falta tocar código: abra un issue o escríbalo en su aporte.

    DÓNDE

    Solo su teléfono y sus ojos.

  2. NIVEL 1

    Corrija un texto

    Una falta de ortografía, una frase confusa o una explicación que se puede decir más simple en las guías o en el README.

    DÓNDE

    site/guias/index.html y README.md

  3. NIVEL 2

    Mejore una explicación de la leyenda

    La leyenda de las guías dice qué es cada cosa en la Ciudad. Si algo no le quedó claro la primera vez que la vio, reescríbalo como le hubiera gustado leerlo.

    DÓNDE

    site/guias/index.html, sección «Qué es cada cosa en la Ciudad»

  4. NIVEL 2

    Traduzca el README al inglés

    Muchas personas encontrarían Atalaya si el README estuviera también en inglés. Una traducción fiel, con su IA como ayuda y su revisión.

    DÓNDE

    Un archivo nuevo, docs/README.en.md

  5. NIVEL 3

    Cree un tema propio

    Diseñe su mundo: un tema es una carpeta con su estilo y su dibujo. El kit trae un simulador con datos reales, así que no necesita un servidor.

    DÓNDE

    El kit de temas y su guía

JEFE FINALSUS DUDAS

Preguntas antes del primer aporte

¿Y si mi cambio está mal?

No pasa nada: nada se publica sin que lo revisemos. Si algo no entra, le decimos por qué y cómo dejarlo listo. Todo el mundo empezó con un primer aporte imperfecto.

¿Tengo que saber programar?

No para las misiones de nivel 1: son textos y pruebas. Para las demás, alcanza con poder pedirle ayuda a su asistente de IA y revisar lo que hace.

¿Qué pasa con mi nombre?

Si su aporte se publica, su nombre (y su enlace, si lo dejó) queda en COLABORADORES.md, en el README y en el sitio, y el cambio queda en el historial del proyecto a su nombre.

¿Qué licencia tiene mi aporte?

La misma del proyecto: AGPL-3.0. Cualquiera puede usarlo, estudiarlo y mejorarlo, y quien lo ofrezca como servicio con cambios debe publicarlos.