feat: update README.md

Author: IbatoLionDev

README.md

@@ -1 +1,87 @@
-# algorithmic-programming-challenges
+# algorithmic-programming-challenges
+
+## Contribution Guidelines
+
+We welcome contributions from developers! You can fork this repository and submit pull requests to:
+
+- Add your own solution proposals to existing challenges.
+- Add new challenges to the collection.
+- Add support for new programming languages.
+
+### Important Notes for Adding New Languages
+
+- When adding a new programming language, please create a separate branch named after the language (e.g., `python`, `java`, `cpp`) instead of committing directly to the `main` branch.
+- This helps keep the main branch clean and organized.
+
+## Recommended Folder Structure
+
+To maintain an organized and scalable project, we suggest the following folder structure:
+
+```
+/<difficulty-level>/
+    /<programming-language>/
+        /<challenge-name>/
+            /proposed-solution/
+                main.<ext>
+                other source files...
+            /@your-github-username/
+                your solution files...
+            article.md
+```
+
+- `<difficulty-level>`: e.g., `1-EASY`, `2-NORMAL`, `3-HARD`
+- `<programming-language>`: e.g., `Python`, `Java`, `C++`
+- `<challenge-name>`: descriptive folder name for each challenge
+- `proposed-solution`: contains the solution source code files by the owner @IbatoLionDev
+- `@your-github-username`: folders for contributors to add their own solutions at the same level as `proposed-solution`
+- `article.md`: contains the bilingual documentation for the challenge
+
+### Note on Solution Folders
+
+The `proposed-solution` folder is exclusive for the solution by the owner @IbatoLionDev. To add your own solutions, please create a folder with your GitHub handle (e.g., `@YourUsername`) at the same level as the `proposed-solution` folder, not inside it. Place your code inside your folder.
+
+If you, as an independent user, feel the need to explain your solution, please prepare an `article.md` file inside your folder.
+
+---
+
+## Guía de Contribución
+
+Damos la bienvenida a contribuciones de desarrolladores. Puedes hacer un fork de este repositorio y enviar pull requests para:
+
+- Añadir tus propias propuestas de solución a retos existentes.
+- Añadir nuevos retos a la colección.
+- Añadir soporte para nuevos lenguajes de programación.
+
+### Notas Importantes para Añadir Nuevos Lenguajes
+
+- Cuando añadas un nuevo lenguaje de programación, por favor crea una rama separada con el nombre del lenguaje (por ejemplo, `python`, `java`, `cpp`) en lugar de hacer commits directamente en la rama `main`.
+- Esto ayuda a mantener la rama principal limpia y organizada.
+
+## Estructura Recomendada de Carpetas
+
+Para mantener un proyecto organizado y escalable, sugerimos la siguiente estructura de carpetas:
+
+```
+/<nivel-de-dificultad>/
+    /<lenguaje-de-programacion>/
+        /<nombre-del-reto>/
+            /propuesta-solucion/
+                main.<ext>
+                otros archivos fuente...
+            /@tu-nombre-de-usuario-github/
+                tus archivos de solución...
+            articulo.md
+```
+
+- `<nivel-de-dificultad>`: por ejemplo, `1-EASY`, `2-NORMAL`, `3-HARD`
+- `<lenguaje-de-programacion>`: por ejemplo, `Python`, `Java`, `C++`
+- `<nombre-del-reto>`: nombre descriptivo para cada reto
+- `propuesta-solucion`: contiene los archivos fuente de la solución del propietario @IbatoLionDev
+- `@tu-nombre-de-usuario-github`: carpetas para que los colaboradores añadan sus propias soluciones al mismo nivel que `propuesta-solucion`
+- `articulo.md`: contiene la documentación bilingüe para el reto
+
+### Nota sobre las carpetas de solución
+
+La carpeta `propuesta-solucion` es exclusiva para la solución del propietario @IbatoLionDev. Para añadir tus propias soluciones, crea una carpeta con tu usuario de GitHub (por ejemplo, `@TuUsuario`) al mismo nivel que la carpeta `propuesta-solucion`, no dentro de ella. Coloca tu código dentro de tu carpeta.
+
+Si tú, como usuario independiente, consideras necesario explicar tu solución, por favor prepara un archivo `articulo.md` dentro de tu carpeta.