Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Stewart-DevTeam-Team/stewart_prealpha/llms.txt

Use this file to discover all available pages before exploring further.

El proyecto Stewart sigue un flujo de trabajo basado en ramas de Git para mantener el historial limpio y facilitar la revisión de cambios en equipo. Cada tarea nueva se desarrolla en su propia rama y se integra a la rama principal mediante un Pull Request revisado por el equipo.
Antes de iniciar cualquier tarea, asegúrate de tener tu rama principal (main) sincronizada con el repositorio remoto. Trabajar sobre una rama desactualizada puede generar conflictos innecesarios.

Flujo de trabajo paso a paso

1

Sincroniza con main

Antes de comenzar, actualiza tu copia local de la rama principal:
git checkout main
git pull
2

Crea una rama para tu tarea

Crea una rama nueva con el formato <tipo>/<nombre-descriptivo>:
git checkout -b feat/sistema-de-inventario
Consulta la sección de nomenclatura de ramas para elegir el tipo correcto.
3

Haz commits siguiendo Commits Convencionales

Registra tus cambios con mensajes descriptivos en el formato de Conventional Commits:
git add .
git commit -m "feat(inventory): agregar lógica base del sistema de inventario"
Consulta la guía de convenciones de commits para más detalles.
4

Sube la rama al repositorio remoto

Publica tu rama en GitHub:
git push origin feat/sistema-de-inventario
5

Abre un Pull Request

Ve a GitHub y abre un Pull Request desde tu rama hacia main. Describe brevemente los cambios realizados y enlaza cualquier issue relacionado para facilitar la revisión del equipo.
Mantén cada rama enfocada en una sola tarea o funcionalidad. Las ramas pequeñas y específicas son más fáciles de revisar, menos propensas a conflictos y más sencillas de revertir si es necesario.

Nomenclatura de ramas

Las ramas siguen el formato <tipo>/<nombre-descriptivo>, donde el nombre describe brevemente la tarea en palabras separadas por guiones.
TipoUso
feat/Nueva funcionalidad
fix/Corrección de errores
docs/Cambios en documentación
chore/Tareas de mantenimiento
refactor/Refactorización sin cambio de comportamiento
art/Assets de arte
Ejemplos:
feat/dialogo-npc
fix/animacion-correr
docs/guia-contribucion
art/sprites-personaje-principal
refactor/sistema-movimiento

GitHub Desktop

Si prefieres una interfaz gráfica, puedes usar GitHub Desktop para gestionar todo el flujo de trabajo: cambiar de rama, hacer commits, resolver conflictos y abrir Pull Requests, sin necesidad de usar la terminal.

Build docs developers (and LLMs) love