Tipos de categorías

En Document360, cada categoría tiene un tipo que determina cómo aparece y se comporta tanto en el portal de la base de conocimiento como en el sitio de la base de conocimientos. Seleccionar el tipo adecuado te ayuda a construir una estructura clara y navegable para tus lectores. Hay cuatro tipos de categorías: Carpeta, Índice, Página y GitHub.

Tipos de categorías en resumen

Carpeta

El tipo de carpeta es el tipo de categoría por defecto y el más comúnmente utilizado. Actúa como un contenedor puro, agrupando artículos y subcategorías bajo un tema común sin generar su propia URL o página de contenido en el sitio de la base de conocimiento.

Usa carpeta cuando:

• Necesitas un grupo de nivel superior para un área temática amplia.
• La categoría no necesita un enlace compartible.
• Quieres que los lectores naveguen por subcategorías o artículos en lugar de acabar en una página de categoría.

Características clave:

• No se genera ninguna URL para este tipo de categoría.
• Soporta operaciones masivas: Ocultar (), Mostrar (), Borrar (), Mover () y Estrella () para artículos dentro de la categoría.
• El icono de categoría se puede personalizar con un emoji.

Índice

El tipo Índice genera su propia URL y muestra una visión general estructurada de todos los artículos dentro de la categoría. Cuando los lectores hacen clic en una categoría de Índice en el sitio de la base de conocimiento, ven una lista de artículos, incluyendo título, colaboradores, fecha de última actualización, estado y etiquetas, antes de abrir uno específico.

Usar Índice cuando:

• Quieres que los lectores tengan una visión general del contenido de una categoría antes de adentrarse en ella.
• La categoría necesita una URL compartible y enlazable.
• Necesitas un punto de entrada estructurado para una gran parte de tu base de conocimientos.

Características clave:

• Se genera una bala única. Puedes compartir enlaces de categorías de índices y aplicar reglas de redirección a ellos.
• Soporta las mismas operaciones masivas que Carpeta: Ocultar, Mostrar, Eliminar, Mover y Estrellar.
• Soporta configuraciones SEO (meta título, slug, descripción) mediante el icono More () > SEO.

Vista del portal:

Vista del sitio de la base de conocimiento:

Cuando los lectores hacen clic en una categoría de Índice, ven el título de la categoría y el número de artículos y subcategorías que contiene.

Página

El tipo de página se comporta como un artículo normal. Puedes escribir, formatear y publicar contenido en él usando el editor Markdown, WYSIWYG o Advanced WYSIWYG. Aún puede contener subcategorías y artículos debajo, lo que la hace adecuada para páginas de destino de secciones que también funcionan como padres de navegación.

Usa Page cuando:

• Quieres una categoría que tenga su propio contenido escrito, como una visión general de sección o una introducción.
• Necesitas funcionalidad completa del artículo (configuración SEO, slug, estado, historial de revisiones) a nivel de categoría.
• La categoría debe contener contenido y actuar como padre para las subcategorías.

Características clave:

• Se comporta exactamente como un artículo normal. Puedes cambiar el título, hacer la slug y realizar todas las mismas acciones a nivel de artículo.
• Permite la configuración de SEO mediante el icono de Más () > SEO.
• A diferencia de un artículo normal, una categoría de Página puede contener subcategorías y artículos adicionales debajo.

Vista del portal:

Vista del sitio de la base de conocimiento:

GitHub

El tipo GitHub sincroniza el contenido documental directamente de un repositorio conectado de GitHub a tu base de conocimientos. Cada rama en el repositorio aparece como un artículo dentro de la categoría, identificada por un icono de rama. Siempre que se envía un commit al repositorio conectado, Document360 extrae automáticamente los archivos Markdown actualizados y los publica.

Usa GitHub cuando:

• Tu documentación vive junto a tu código en un repositorio de GitHub y se mantiene en GitHub.
• Quieres documentos controlados por versiones que se mantengan sincronizados con las liberaciones de código automáticamente.
• Tu equipo prefiere escribir Markdown en un editor local en lugar del editor de Document360.

Características clave:

• El contenido sincronizado desde GitHub es de solo lectura en Document360. Todas las ediciones deben realizarse en el repositorio fuente de GitHub.
• Solo se soporta la rama principal para sincronización.
• Cada rama en el repositorio conectado aparece como un artículo con un icono de rama en el portal.
• Los usuarios no pueden editar ni publicar artículos en una categoría de GitHub. Todos los cambios deben originarse en el repositorio de GitHub.
• El icono de GitHub se muestra solo para categorías públicas .
• No se pueden crear nuevos artículos dentro de Document360 para categorías sincronizadas con GitHub.

Comparando tipos de categorías

Cambiar el tipo de categoría

Puedes cambiar el tipo de categoría en cualquier momento sin perder contenido.

1. Navega a Documentación () en la barra de navegación izquierda.
2. Pasa el cursor sobre la categoría en el panel de Categorías y Artículos .
3. Haz clic en el icono de Más () y selecciona Cambiar tipo.
4. Selecciona el nuevo tipo de categoría y haz clic en Actualizar.

Mejores prácticas

• Usa Carpeta para categorías de nivel superior que existen únicamente para navegar. Es el tipo más sencillo y no genera URLs innecesarias.
• Utiliza Índice para secciones grandes donde los lectores se benefician de ver un resumen del artículo antes de navegar, por ejemplo, por una referencia de API o una larga guía de solución de problemas.
• Usa Página para páginas de destino de secciones que necesiten contenido introductorio junto a artículos hijos, por ejemplo, una página de "Inicio" que explique la sección y enlaces a artículos hijos.
• Usa GitHub solo cuando tu documentación esté activamente mantenida en un repositorio y necesites sincronización automática, no para importaciones puntuales.
• Evita cambios frecuentes de tipo en las categorías de mucho tráfico. Convertir a Página deja la categoría en estado de borrador, lo que puede causar enlaces rotos hasta que se publique.

Preguntas frecuentes