Skip to content

README.md

Latest commit

 

History

History
166 lines (133 loc) · 5.71 KB

README.md

File metadata and controls

166 lines (133 loc) · 5.71 KB

revilofe.github.io

Repositorio de material educativo para formación profesional en desarrollo de aplicaciones web y ciberseguridad.

Este repositorio contiene documentación, prácticas, presentaciones y recursos educativos organizados por módulos temáticos para estudiantes de ciclos formativos de desarrollo de aplicaciones web.

📚 Módulos Disponibles

🎯 Programación (section1)

Contenido básico de programación con Python, Kotlin y otros lenguajes.

  • U1: Primer programa en Python
  • U2: Estructuras de control
  • U3: Estructuras de datos
  • U4: Kotlin: POO y estructuras de datos
  • U5: Kotlin: PPO y creación de e.d.
  • U6: Kotlin: Creación de programas con POO
  • U7: Kotlin: Entrada/Salida y GUI
  • U9: Acceso a base de datos relacionales

🔒 Incidentes de Seguridad (section2)

Contenido sobre gestión de incidentes de ciberseguridad.

  • U0: Nos conocemos
  • U1: Principios generales y planes de seguridad
  • U2: Detección y análisis de incidentes
  • U3: Investigación de incidentes

🛠️ Entornos de Desarrollo (section3)

Herramientas y metodologías para desarrollo de software.

  • U1: Introducción al desarrollo de software
  • U2: Entornos de desarrollo integrado
  • U3: Pruebas y Depuración
  • U4: SCV, refactorización y documentación
  • U5: Pruebas y Depuración (actualizado)

🚀 Despliegue de Aplicaciones Web (section4)

Tecnologías para despliegue y DevOps.

  • U1: Documentación y Control de versiones
  • U2: Contenedores Docker

Estos módulos, junto con Programación, usan diagramas UML y diagramas explicativos con Mermaid para reforzar conceptos, ejemplos y documentación.

📁 Estructura del Repositorio

├── docs/                          # Documentación principal (MkDocs)
│   ├── section1/                  # Programación
│   │   ├── u01/                   # Unidades didácticas
│   │   │   ├── index.md           # Descripción de la unidad
│   │   │   ├── teoria/            # Contenidos teóricos
│   │   │   ├── practica/          # Prácticas y ejercicios
│   │   │   └── gift/              # Preguntas para cuestionarios
│   │   └── ...
│   ├── section2/                  # Incidentes de seguridad
│   ├── section3/                  # Entornos de desarrollo
│   └── section4/                  # Despliegue web
├── slides/                        # Presentaciones (Reveal.js)
│   ├── section1-pr/               # Slides de programación
│   ├── section2-is/               # Slides de seguridad
│   ├── section3-ed/               # Slides de entornos desarrollo
│   └── section4-daw/              # Slides de despliegue
├── mkdocs.yml                     # Configuración de MkDocs
├── AGENTS.md                      # Guía para agentes/contribuidores
└── README.md                      # Este archivo

🎯 Cómo Usar el Contenido

Documentación

  1. La documentación principal está en /docs/
  2. Se genera automáticamente con MkDocs
  3. Cada módulo tiene unidades didácticas con teoría y práctica

Presentaciones

  1. Las slides están en /slides/
  2. Formato Reveal.js (HTML + Markdown)
  3. Abrir los archivos .html en un navegador

Contenido por Módulo

  • Teoría: Contenidos conceptuales y explicaciones
  • Práctica: Ejercicios y actividades evaluables
  • Slides: Presentaciones complementarias

🤝 Cómo Contribuir

Requisitos Previos

  • Conocimientos básicos de Git y GitHub
  • Familiaridad con Markdown
  • Experiencia en desarrollo web (opcional)

Proceso de Contribución

  1. Fork del repositorio

    # Haz fork en GitHub y clona tu fork
git clone https://github.com/TU_USUARIO/revilofe.github.io.git
cd revilofe.github.io

  2. Crear una rama para tus cambios

    git checkout -b feature/nueva-funcionalidad
# o
git checkout -b fix/correccion-error

  3. Realizar cambios siguiendo la estructura

    • Documentación: /docs/sectionX/uXX/teoria/ o /practica/
    • Slides: /slides/sectionX-XX/
    • Mantener consistencia en nomenclatura

  4. Convenciones de nomenclatura

    • Documentos: MODULO-UX.Y.-Tema.md
    • Slides: MODULO-UX.Y.-Tema.html/.md
    • Prácticas: MODULO-UX.-PracticaYYY.md

  5. Validar cambios

    # Verificar que MkDocs funciona
mkdocs serve

# Verificar slides abriendo archivos .html

  6. Commit y push

    git add .
git commit -m "Descripción clara de los cambios"
git push origin feature/nueva-funcionalidad

  7. Crear Pull Request

    • Ve a GitHub y crea un PR desde tu rama
    • Describe claramente qué cambios introduces
    • Espera revisión y feedback

Tipos de Contribuciones

  • ✅ Correcciones: Errores tipográficos, enlaces rotos
  • ✅ Mejoras: Claridad, ejemplos adicionales
  • ✅ Nuevo contenido: Teoría, prácticas, slides
  • ✅ Actualizaciones: Tecnologías, mejores prácticas
  • ✅ Traducción: Si aplica

Guías de Estilo

  • Markdown: Usar sintaxis clara y consistente
  • Código: Incluir ejemplos funcionales
  • Enlaces: Verificar que funcionen
  • Imágenes: Optimizar tamaño y formato
  • Diagramas Mermaid/UML: Usar la skill mermaid-diagram-creator
  • Workflow de skills: Ver skills/README.md

Contacto

Para preguntas o sugerencias:

  • Crear un Issue en GitHub
  • Revisar AGENTS.md para guías detalladas

Nota: El seguimiento de cambios locales en workspace.xml se puede prevenir con:

git update-index --assume-unchanged .idea/workspace.xml
# Para revertir: git update-index --no-assume-unchanged .idea/workspace.xml