English | Español

📚 Guías de Estudio sobre ROS2 a partir de Repositorios Destacados

Este repositorio reúne una serie de guías de estudio diseñadas para aprender ROS2 (Robot Operating System 2) explorando proyectos públicos relevantes. Cada guía desglosa un repositorio específico mediante explicaciones teóricas, diagramas visuales, ejemplos y comandos prácticos.

🎯 Objetivo del Proyecto

• Comprender los fundamentos de ROS2 a través del análisis de proyectos reales.
• Estructurar el conocimiento con apoyo visual (Mermaid, tablas Markdown, etc.).
• Servir como recurso de estudio para estudiantes y autodidactas interesados en robótica.
• Documentar el proceso de aprendizaje de manera clara, progresiva y compartible.

🧭 ¿Qué encontrarás aquí?

Cada carpeta contiene una guía en formato README.md, la cual incluye:

✅ Introducción al repositorio analizado
✅ Explicación de conceptos teóricos clave en ROS2
✅ Guía de instalación y configuración
✅ Estructura del proyecto con diagramas
✅ Instrucciones de ejecución y pruebas
✅ Análisis de nodos, tópicos, servicios y acciones
✅ Recursos adicionales y próximos pasos

📁 Guías Disponibles

Guía	Descripción	Enlace
MOGI-ROS	Framework educativo con simulación Gazebo para aprendizaje práctico de ROS2	Ver Guía

🔧 Nuevas guías serán añadidas conforme avance el estudio de otros repositorios ROS2.

💡 Sobre esta iniciativa

Este proyecto es parte de mi proceso personal de aprendizaje autodidacta. Considero que estudiar el código de proyectos reales es una forma poderosa de consolidar conocimientos. Si tú también estás aprendiendo ROS2, ¡espero que estas guías te sean útiles!

🤝 Contribuciones

¡Las contribuciones son bienvenidas!

Si deseas aportar una nueva guía de estudio, por favor sigue estas recomendaciones:

1. 📂 Crea una carpeta con el nombre del repositorio que estás documentando.
   Ejemplo: NombreDelRepo/

2. 📄 Incluye dos archivos README.md: uno en español y otro en inglés.

   • README.md → Versión en español
   • README-en.md (o README_EN.md) → Versión en inglés
     Puedes usar etiquetas como <p align="center"><a href="./README-en.md">English</a> | Español</p> para enlazarlos entre sí.

3. 🧠 Incluye contenido claro, estructurado y visual:

   • Tablas, comandos explicativos y diagramas (puedes usar Mermaid).
   • Breves explicaciones teóricas cuando sea necesario.

4. ✅ Verifica que los comandos sean funcionales y estén actualizados.

5. 📬 Haz un Pull Request explicando brevemente qué incluye tu aporte.

Tu contribución puede ayudar a muchas otras personas que están aprendiendo ROS. ¡Gracias por compartir!

📄 Licencia

Este repositorio está licenciado bajo la Licencia MIT.
Puedes usar, modificar y compartir el contenido con libertad, siempre y cuando conserves los créditos originales.

Consulta el archivo LICENSE para más detalles.