Read this guide in other languages
Este es un proyecto relativamente sencillo, proyecto de código abierto amigable para los principiantes que es una excelente elección para contribuir para quienes quieren hacer sus primeras contribuciones al open source. Como sea, cualquiera es libre de contribuir.
El propósito de este proyecto es crear una base de datos de algoritmos usando el lenguaje de programación de tu elección, donde cada algoritmo retorna el enésimo elemento de una de las secuencias de enteros notables listadas en el siguiente en lace de wikipedia: https://en.wikipedia.org/wiki/List_of_integer_sequences
Este enlace a wikipedia contiene una lista de muchas secuencias de enteros notables, tales como los números primos, la secuencia Kolakoski, números Motzkin, números Lucas, etc...
'n' Representa un entero ingresado por el usuario. Por ejemplo, si el usuario ingresa el entero '2', entonces tu algoritmo debe retornar el tercer elemento de la secuencia (porque la indexación inicia en 0, el primer elemento de la secuencia is para n=0, el secuendon elemento es para n=1, etc)
Si alguien necesita implementar una de las más oscuras secuencias de enteros listadas en la página de wikipedia dentro de su propio programa, es probable que tengan que desarrollar sus propios algoritmos. Cualquiera es libre de usar el código de este proyecto en su propio software, no hay necesidad de pedir permiso porque este proyecto no usa licencia.
Echa un vistazo al enlace de wikipedia https://en.wikipedia.org/wiki/List_of_integer_sequences
Mira la lista de secuencias de números enteros notables y desarrolla un algoritmo en cualquier lenguaje de programación para retornar el enésimo elemento de la secuencia. La indexación comienza en 0, así que si el usuario ingresa n=0, esto retornará el primer elemento de la secuencia, n=1, retorna el segundo elemento, etc. Mira el repositorio del proyecto para asegurarte que el código para la secuencia de enteros que has elegido no haya sido agregado al proyecto en el lenguaje de programación de tu elección.
Por ejemplo, si alguien ha creado un algoritmo en Python para los números Bell y lo ha agregado al proyecto, aún puedes crear un algoritmo para los números Bell en cualquier otro lenguaje, pero no en Python.
Si no existe código para una secuencia de enteros específica en el repositorio de este proyecto, puedes crear el código para esta secuencia de enteros en cualquier lenguaje de programación que quieras.
Mira el código que ya existe dentro del repositorio del proyecto, usa esto para orientarte y ayudarte a desarrollar tu propio algoritmo.
Después de que estés feliz con el código que has desarrollado, envía un pull request usando la plantilla de pull request. Entonces revisaré tu código para confirmar que funciona como se espera, y entonces agregarlo al repositorio del proyecto. Si tu código produce la salida correcta, siempre será agregado al repositorio del proyecto, independientemente de la calidad del código/estándares de codificación, e independientemente de la velocidad del código.
También puedes mejorar y modificar código existente en el proyecto, enviar pull request y siempre revisaré tus cambios. Por ejemplo, puedes mejorar la velocidad del código, o mejorar los estándares de codificación al añadir comentarios, espacios, cambiando nombres de variables, etc.
Como este proyecto está dirigido a principiantes, quiero explicar brevemente la manera más simple de enviar pull request para aquellos que no sepan.
Abre mi repositorio y da click en "Fork". Esto crea una copia bifurcada del repositorio.
Agrega tu código a la copia bifurcada.
Regresa a mi repositorio y da click en "submit pull request". Click en "compare across forks". Selecciona tu copia del repositorio bifurcada como HEAD y mi repositorio como la BASE.
Click en submit pull request y deja comentarios significativos explicando el código que estás intentando agregar al ´proyecto.
Alternativaente, puedes usar los siguientes comandos de git:
- Para clonar el repositorio en tu sistema local usa
git clone enlace-al-repositorio nombre-directorio
- Para preparar los archivos que has cambiado usa
git add nombre-archivo
- En caso de que hayas modificado varios archivos y quieras prepararlos todos a la vez usa
git add .
- Para confirmar estos cambios usa
git commit -m "Solucionado problema #número del problema"
- Para hacer push usa
git push origin nombre-de-rama