Las categorías son la principal forma de organizar el contenido en tu base de conocimiento. Antes de empezar a añadir artículos, establecer una estructura clara por categorías ayuda a los lectores a navegar por tu documentación y a tu equipo a gestionar el contenido a gran escala.
¿Cuándo necesitas una nueva categoría?
Crea una nueva categoría cuando necesites:
- Agrupa los artículos relacionados bajo un tema común, por ejemplo, una categoría de "Cómo empezar" para el contenido de incorporación.
- Separa el contenido por audiencia: Crea categorías distintas para usuarios finales, administradores y desarrolladores.
- Refleja la estructura de tu producto: Alinea las categorías con áreas de producto, características o módulos para que los lectores encuentren contenido donde lo esperan.
- Añadir una subcategoría a una categoría existente cuando un tema crece lo suficiente como para necesitar una división adicional.
Puedes crear hasta 1.000 categorías por espacio de trabajo. Los nombres de las categorías tienen un máximo de 300 caracteres , incluyendo espacios.
Crear una categoría
La forma más común de crear una categoría es usando el botón Crear en la barra superior de navegación.
- Navega a Documentación () en la barra de navegación izquierda.
- Haz clic en el desplegable Crear y selecciona Categoría.
- En el panel Crear nueva categoría, rellena lo siguiente:
| Campo | Qué hacer |
|---|---|
| Nombre | Introduce un nombre para la categoría (máximo 300 caracteres) |
| Ubicación | Elige dónde se sitúa la categoría, a nivel raíz o dentro de una categoría existente. Haz clic en Reiniciar para colocarlo en la raíz |
| Tipo | Selecciona un tipo de categoría: Carpeta, Índice, Página o GitHub |
- Haz clic en Crear. La nueva categoría se añade de inmediato.
Para saber más sobre los tipos de categorías, lee Tipos de categoría.
También puedes crear una categoría usando el icono del volante de inercia pasando el cursor justo debajo de cualquier categoría en el panel de Categorías y Artículos , desde el icono Más () junto a una categoría existente, desde el desplegable Crear dentro de una categoría de Carpeta o Índice , o directamente desde el panel Crear nuevo artículo haciendo clic en Crear categoría en el desplegable de Categoría.
Todos los puntos de entrada se abren en el mismo panel Crear nueva categoría con los mismos campos Nombre, Ubicación y Tipo.
Niveles de subcategoría
Puedes anidar categorías de hasta siete niveles de profundidad, una categoría raíz más seis niveles de subcategoría.
La opción de nueva categoría queda inactiva una vez que alcanzas el séptimo nivel.
Utiliza hasta tres niveles de subcategoría para una navegación óptima. Dos niveles es ideal para la mayoría de las bases de conocimiento. Las jerarquías más profundas dificultan que los lectores encuentren contenido sin usar la búsqueda.
Cambia el icono de categoría
Cuando creas una categoría, se asigna un icono de carpeta por defecto. Puedes cambiarlo por un emoji para que la categoría sea más fácil de identificar de un vistazo.
- Navega a Documentación () en la barra de navegación izquierda.
- En el panel de Categorías y Artículos , haz clic en el icono de carpeta o en el emoji existente junto a la categoría deseada.
- Aparece un panel de emojis. Busca un emoji usando la barra de búsqueda, navega por categoría o filtra por tono de color.
- Selecciona el emoji que quieras para aplicarlo.
- Para volver al icono de carpeta por defecto, haz clic en el 🚫 icono del panel de emojis.
- Los estilos de emoji pueden variar según el navegador.
- Los iconos de categoría solo pueden cambiarse para categorías de tipo Carpeta e Índice . Las categorías de tipos de página no admiten iconos personalizados.
Mejores prácticas
- Nombra categorías desde la perspectiva del lector: Utiliza un lenguaje que tus lectores usarían al buscar contenido, no terminología interna del equipo.
- Sé coherente con el formato: Decide el caso del título o la oración y aplícalo de forma uniforme en todas las categorías.
- Empieza de forma general, luego estrecha: las categorías raíz deben cubrir temas amplios; Las subcategorías deberían dividirlas en áreas específicas y específicas.
- Evita las categorías de un solo artículo: Si una categoría solo contiene un artículo, considera si pertenece a una categoría más amplia.
- Utiliza iconos de emojis de forma intencionada: Los emojis ayudan a los lectores a identificar categorías rápidamente de un vistazo. Elige aquellos que representen claramente el tema.
Preguntas frecuentes
¿Qué tipos de categorías puedo crear?
Puedes crear cuatro tipos: Carpeta, Índice, Página y GitHub. Cada tipo tiene un comportamiento y casos de uso diferentes. Consulta Tipos de categoría para más detalles.
¿Puedo cambiar el tipo de categoría después de crearlo?
Sí. Puedes cambiar el tipo de categoría en cualquier momento después de haberla creado. Consulta Tipos de categorías para más detalles.
¿Puedo crear subcategorías bajo una categoría principal?
Sí. Puedes crear hasta siete niveles de categorías, una categoría raíz y seis niveles de subcategoría. La opción de Nueva categoría queda inactiva más allá del séptimo nivel.
¿Puedo cambiar el icono de categoría por un emoji?
Sí, pero solo para categorías de Carpeta e Índice . Las categorías de tipos de página no admiten iconos personalizados. Para volver al icono de carpeta por defecto, haz clic en el 🚫 icono del panel de emojis.
¿Por qué mi nueva categoría no es visible en la página de la base de conocimientos?
Una categoría no aparecerá en la base de conocimientos si no tiene artículos publicados, si está oculta o si todos los artículos dentro de ella están ocultos o no publicados. Publica al menos un artículo dentro de la categoría para que sea visible.