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.
Cuatro pasos, de principio a fin.
- 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.
- Á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.
- 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 sitioarma la carpetasitio, y la abre con un servidor local (su IA le dice cómo en su sistema). - 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.
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.
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.
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.
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.
¿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.
- 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ÓNDESolo su teléfono y sus ojos.
- 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ÓNDEsite/guias/index.htmlyREADME.md - 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ÓNDEsite/guias/index.html, sección «Qué es cada cosa en la Ciudad» - 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ÓNDEUn archivo nuevo,
docs/README.en.md - 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ÓNDEEl kit de temas y su guía
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.