/first-pr

Your first Pull Request Coder ;)

Primary LanguageTypeScript

Un reto simple

NOTA: Anteriormente este repositorio fue abierto para incorporar gente a un proyecto.
Actualmente se encuentra abierto a todo aquel que quiera intentar el ejercicio.

El reto

Saber javascript y saber leer documentación es básico. Es algo que damos por hecho que pueden hacer.
La tarea es sencilla:

  • Elegir un método de array o string (el que más les guste).
  • Hacer un muy breve resumen del método.
  • Hacer un código muy muy cortito (5 líneas o más, lo que quieran) en donde usen el método que eligieron.

Recursos: https://developer.mozilla.org/es/docs/Web/JavaScript/Referencia/Objetos_globales

Saber tener un código documentado es importante para expresarte en el desarrollo de software. Algunos algoritmos pueden ser muy complejos para ser explicados mediante código, por lo que se requiere recursos adicionales.

  • Encapsula el código anterior dentro de una función que reciba al menos un parámetro.
  • Documenta la función utilizando JSDoc.

Recursos: https://jsdoc.app/

Saber trabajar con las herramientas colaborativas es fundamental para este proyecto. Para eso, subiran la función que hicieron a un repositorio en github, mediante un pull request, siguiendo un flujo más o menos común.

  • Crear un issue en el repositorio siguiendo la plantilla de postulación que verán a la hora de crearlo.
  • Seguir los pasos del readme.md del repositorio.
  • Hacer el pull request.

Recursos: https://gist.github.com/EnzoDiazDev/31e73d0573142d0573eb58d69a5158fd
Repositorio: Este es el repositorio.

Si esto les parece que puede ser mucho o muy complejo, creanme que lo hacen en menos de cinco minutos.
Esto es una pruebita muy muy sencilla, es algo que van a realizar tooooodo el tiempo, así que no debería parecerles difícil.
Una vez hecho, están dentro.

Cómo contribuir

Crea un issue siguiendo la plantilla de postulación.
Crea un fork y clona tu fork (podés guiarte sigiendo los pasos del gist)
Tu pull request deberá ser de un archivo nuevo, con tu username de Discord en el canal de Fazt (o de github si no formas parte de la comunidad), de extensión .js o .ts.
El archivo tendrá que tener los pasos realizados hasta el punto 5.
El punto 2 (breve resumen), debe estar al inicio del archivo en forma de comentario.
A la hora de realizar el pull request, crea una referencia al issue* que abriste anteriormente y, como descripción de este, explica brevemente por qué elegiste ese método para esta tarea.

Importante

Si es tu primera vez, no hagas preguntas sobre esto. Seguí los pasos como sea que lo hayas entendido, y sabrás si está bien o no a la hora de revisar tu pull request.
Es importante tener valentía e independencia para realizar las contribuciones, pues la documentación y este tipo de recursos debería ser suficiente para lograr contribuir eficientemente.

Nota: No es necesario seguir formalidades, hacelo con tu estilo y como te guste. Solo asegurate de cumplir los pasos.

*usa Resolves [url de tu issue] en la descripción de tu pullrequest para linkear el issue a éste.