rhymus

Rima

Un proyecto de juego de rima de código abierto diseñado para nuevos desarrolladores y colaboradores por primera vez.

Noticias

¡A partir del 22 de enero, la sucursal master-vue ya está listo y listo para las contribuciones! Puede usar la rama master existente como modelo para cómo se debe desarrollar la aplicación VUE. En el proyecto VUE se incluyen pruebas unitarias (usando broma) y VUEX (para la gestión estatal).

Las mejoras adicionales a la rama master de vainilla aún son bienvenidas. React tendrá su propia sucursal configurada en algún momento en febrero.

Como desarrollador profesional VUE, estaré particularmente involucrado con las contribuciones y cualquier pregunta que se produzca con respecto a la rama master-vue , ¡así que no dude en pedir consejos y hacer esos PR!

Jugabilidad

Rhymus es un juego de código abierto que mostrará cartas con oraciones sobre ellas. Cada oración tendrá una palabra que no tiene sentido, pero rima con una palabra que sí. Por ejemplo, 'Tengo una niebla mascota'. -> Respuesta: 'perro'. Un temporizador le da 30 segundos para completar la mayor cantidad posible.

Diseño

Este proyecto pasará por dos fases . La primera será una construcción inicial utilizando un back-end de nodo y HTML, CSS y JS front-end. Para la primera compilación, no habrá implementación React/Redux.

Una vez que se complete la primera compilación y complete las características, se crearán dos nuevas ramas en las que el proyecto se refactorará utilizando React y Vue .

Contribuciones

Este proyecto está comenzando desde cero, por lo que hay amplias oportunidades para contribuir. La forma más rápida de contribuir es consultar la pestaña Proyectos y ver qué prioridades hay . De lo contrario, cualquiera de los siguientes es una excelente manera de contribuir:

• Editar el readme
• Creación de archivos nuevos para la estructura del proyecto
• Reestructurar el proyecto para cumplir con las mejores prácticas
• Codificación de cualquiera de los front-end o back-end
• Codificación de archivos de prueba
• Ofreciendo un estilo alternativo
• Sugiriendo mejores prácticas para la gestión de Github (incluidas las pautas de contribución)

Pautas de contribución

Cuando contribuye, utilice las siguientes pautas:

• Nombra tu sucursal de una manera que refleje lo que planea hacer ('implementar la scrroll de tarjetas')
• Proporcione información detallada en su solicitud de extracción sobre lo que hizo y por qué se hace de esa manera
• En su solicitud de extracción, reflexione sobre su código e incluya comentarios sobre si puede necesitar refactorización o si algo fue particularmente difícil
• Incluya pruebas con su contribución si corresponde

Este es un proyecto de código abierto para desarrolladores de todos los niveles de experiencia. Muestre la cortesía común y proporcione comentarios constructivos cuando sea posible.

Guía completa para principiantes

Si es completamente nuevo en contribuir a proyectos de código abierto o usar GIT, siga esta pequeña guía para hacer su primer PR. Tenga en cuenta que hay muchas maneras de completar esto, pero esto está diseñado para ser muy básico y fácil de seguir. Si no es así, ¡corrígelo!

1. Haga clic en la horquilla en la parte superior derecha para hacer una copia de este repositorio.
2. Suponiendo que haya instalado Gitbash, haga clic con el botón derecho en su carpeta de documentos (donde almacena carpetas de proyecto) y abra en Gitbash.
3. Escriba git clone https://[email protected]/username/rhymus .
4. Abra esta carpeta en su IDE (como el código Visual Studio).
5. En su terminal (Abra desde el desplegable terminal superior en el código VS), escriba git checkout -b add-puzzle .
6. A la izquierda, abra la carpeta SRC , luego la carpeta JS y abra Puzzles.js .
7. Siga el patrón que ve allí y cree un nuevo rompecabezas de rima y guarde sus cambios.
8. En su terminal, escriba git commit -m "added new puzzle" .
9. En su terminal, escriba git remote add origin https://[email protected]/username/rhymus .
10. En su terminal, escriba git push origin add-puzzle .
11. En GitHub, vaya a su repositorio y seleccione la rama Add-Puzzle .
12. Haga clic en el nuevo botón de solicitud de extracción y llénelo.

¡Hecho!

Pero espera, ¿qué acaba de pasar?

1. El bifurcado creó una copia del repositorio en su cuenta GitHub. 2 - 3) Usando Gitbash, coloca una copia de ese repositorio en su máquina local donde puede abrir y editar todos los archivos. La clonación solo hace una copia exacta del repositorio al que apunta la URL. 4 - 5) Abriste la carpeta y creaste una nueva rama. El pago se mueve a una nueva rama, y ​​el -b significa que creará la nueva rama. 6 - 7) Agregaste un nuevo rompecabezas que sigue al patrón, ¡con suerte!
2. ¡Te cometiste tu guardado! Esto significa que ha guardado oficialmente y preparó sus cambios para ser presionados oficialmente a su repositorio. El -m significa un mensaje adjunto a la confirmación para que usted y otros puedan ver de qué se trata la confirmación.
3. ¡Agregaste un control remoto! Este es un lugar al que empujará regularmente. Solo agregará un solo control remoto una vez, luego le dará un apodo (generalmente origen) que puede usar en lugar de escribir la URL larga cada vez.
4. ¡Empujó desde su guardado local a su repositorio en la rama Add-Puzzle! ¡Su compromiso está oficialmente en su repositorio en línea! 11 - 12) ¡Hizo una solicitud de extracción, que es una solicitud para el repositorio original (este) para aceptar sus cambios en la base!

Tal vez estás pensando: "Espera, ¿y si mi código es terrible? ¿O roto? ¿O completamente equivocado?" ¡No importa! Cuando realiza una solicitud de extracción, su código será revisado antes de fusionarse en el repositorio oficial. Si necesita cambios, recibirá comentarios explicando qué, cómo y por qué cambiar. Una vez que realice cambios, puede presionar nuevamente y actualizará automáticamente su solicitud de extracción (así que no lo cierre si no está aprobado de inmediato). Comentar esos errores es exactamente cómo aprenderás.

Si te sientes audaz, haz más cambios, compromisos, empujes y relaciones públicas.

Sobre el autor

Soy un desarrollador de software completo que actualmente trabaja en Tokio, Japón. Pongo este proyecto juntos para solidificar y compartir mi conocimiento de la programación. También ofrezco programas de metorship a programadores en ciernes en bloques de tres meses, así que no dude en visitarme en LinkedIn y contácteme si está interesado en encontrar un mentor.