GitScrum / Docs
Available for VS Code, Cursor, Windsurf, and any VS Code forkInstall from Marketplace

Wiki

Crea y gestiona la documentación de tu proyecto directamente desde tu editor de código. Navega páginas jerárquicas, edita con Markdown, rastrea revisiones y busca en toda tu base de conocimiento.


El problema que esto resuelve

La documentación del proyecto está en una herramienta, el código en otra. Cuando necesitas consultar especificaciones de API, decisiones de arquitectura o guías de configuración, cambias al navegador, buscas la página del wiki, la lees y luego vuelves. Cada cambio de contexto interrumpe tu flujo.

GitScrum Studio coloca el wiki dentro de un panel del editor. Consulta la documentación mientras programas, actualízala mientras implementas y nunca abandones tu entorno de desarrollo.


Lo que estás viendo

Haz clic en Wiki en la sección Knowledge del árbol lateral. El panel se abre con una navegación en árbol a la izquierda y un área de contenido a la derecha.

Árbol de páginas

El lado izquierdo muestra todas las páginas del wiki organizadas jerárquicamente. Las páginas pueden contener páginas secundarias, creando estructuras anidadas para una documentación organizada:

Primeros pasos
  ├─ Guía de instalación
  ├─ Configuración
  └─ Despliegue
Referencia de API
  ├─ Autenticación
  ├─ Endpoints
  └─ Códigos de error
Arquitectura
  └─ Esquema de base de datos

Expande y contrae las páginas principales para navegar por el árbol. Haz clic en cualquier página para cargar su contenido en el panel derecho.

Área de contenido

El lado derecho muestra el contenido de la página seleccionada. En la parte superior, verás el título de la página y la navegación de migas de pan que indica la posición de la página en la jerarquía.


Crear páginas

Haz clic en el botón de crear en el encabezado del panel para abrir el formulario de nueva página:

CampoDescripción
TítuloEl nombre de la página que se muestra en el árbol y el encabezado
ContenidoCuerpo de la página en formato Markdown
PadreOpcional — selecciona una página existente para anidar la nueva página debajo de ella

Deja el campo padre vacío para crear una página en el nivel raíz. Selecciona una página existente como padre para crear una página secundaria anidada.


Editar páginas

Haz clic en el botón de editar en cualquier página para cambiar al modo de edición. El área de contenido se transforma en un editor donde puedes modificar:

  • Título — El encabezado de la página
  • Contenido — Edición completa en Markdown con formato estándar

Guarda tus cambios o cancela para revertir. Las ediciones se guardan en el servidor inmediatamente.


Historial de revisiones

Cada edición crea una revisión. Haz clic en el botón de revisiones para ver el historial de cambios de la página:

ColumnaDescripción
RevisiónNúmero de revisión (secuencial)
Tipo de cambioQué cambió: creado, contenido, título o restaurado
AutorQuién realizó el cambio
FechaCuándo se realizó el cambio

Restaurar versiones anteriores

Puedes restaurar cualquier revisión anterior. Esto crea una nueva revisión que revierte el contenido a la versión seleccionada. El contenido previo se conserva en el historial — nada se pierde permanentemente.


Eliminar páginas

Haz clic en el botón de eliminar en una página para borrarla. Aparece un diálogo de confirmación antes de la eliminación. Eliminar una página principal puede afectar las páginas secundarias — revisa la jerarquía cuidadosamente antes de confirmar.


Búsqueda

Usa el campo de búsqueda en la parte superior del panel del wiki para filtrar páginas. La búsqueda se ejecuta en los títulos de las páginas y muestra resultados en tiempo real mientras escribes.


Consejos avanzados (una vez que te sientas cómodo)

  • Vista dividida con código. Abre el panel del wiki junto a tus archivos de código. Consulta documentación de API o guías de arquitectura mientras implementas.
  • Usa el anidamiento para estructurar. Organiza las páginas por módulo, funcionalidad o equipo. Las jerarquías profundas son más fáciles de navegar que listas planas de páginas.
  • Documenta mientras programas. Cuando implementes un algoritmo complejo o configures una integración complicada, actualiza el wiki inmediatamente. Toma 30 segundos mientras el contexto está fresco vs. 30 minutos después cuando hayas olvidado los detalles.
  • Revisa las revisiones antes de editar. Si un compañero actualizó una página recientemente, revisa sus cambios para evitar sobrescribir su trabajo.

Permisos

La extensión respeta los permisos de tu cuenta de GitScrum:

  • Propietarios de agencia y Managers: Acceso CRUD completo a todas las páginas del wiki
  • Desarrolladores: Pueden crear, editar y ver páginas del wiki en proyectos asignados
  • Clientes: Acceso de solo lectura a las páginas del wiki (si se les otorgó acceso al proyecto)

Cómo reportar un problema o solicitar una funcionalidad

Si las páginas del wiki no cargan, los cambios no se guardan o el historial de revisiones aparece incompleto, abre un ticket de soporte en la aplicación web de GitScrum. Navega a Support Tickets en la barra lateral y describe el problema. Incluye la versión de la extensión y los detalles del editor.