La biblioteca Docs

Usa Documentation → Docs library en el sitio de documentación para inspeccionar documentos dentro de su jerarquía de categorías, encontrar borradores o entradas desactualizadas y ordenar manualmente los documentos que no están controlados por un manifiesto Markdown.

Cómo abrirla

Abre Documentation → Docs library. Necesitas permiso para editar las publicaciones de documentación de otros usuarios. La pantalla solo está disponible en el sitio de documentación dedicado.

El resumen superior muestra el número de documentos, categorías, publicados, sin categorizar y borradores. Standard list vuelve a la tabla normal de WordPress, y Add document abre el editor de documentos normal cuando tu cuenta puede crear documentos.

Qué muestra

Todos los documentos que no están en la papelera se cargan en una única vista con prioridad en la jerarquía:

• Primero los documentos sin categorizar, en su propia sección.
• Después, el árbol completo de categorías, en profundidad: una categoría padre, sus hijas y sus descendientes, con los documentos agrupados debajo de cada una.

Un documento asignado a varias categorías aparece una sola vez, bajo su categoría asignada más profunda. Cuando dos categorías asignadas tienen la misma profundidad, gana la primera que aparece en el árbol visible. Cada ruta asignada sigue mostrándose como una etiqueta en la tarjeta del documento.

Las categorías sin documentos también se muestran, a menos que actives Hide empty categories. Aquí, "vacía" significa que no hay documentos agrupados directamente bajo esa categoría; puede contener, aun así, categorías hijas con contenido.

Ordenar documentos

Arrastra la tarjeta de un documento por su tirador de movimiento para subirla o bajarla dentro de su categoría. Al soltarla se guarda el orden visible completo de esa categoría, y un mensaje junto a la categoría confirma el guardado o te indica que recargues.

Tres limitaciones que conviene conocer antes de intentarlo:

• No puedes arrastrar un documento a otra categoría. Cambia sus categorías en el propio documento.
• Los documentos sin categorizar no se pueden reordenar desde esta pantalla.
• El orden se desactiva mientras una búsqueda o un filtro de estado oculta parte de una categoría. Borra la búsqueda y selecciona All statuses primero.

Los documentos sincronizados se ordenan según el manifiesto

Para la documentación gestionada por Sync docs, el manifiesto del producto es la fuente autorizada. Una sincronización posterior restaura el orden de cada documento a partir de él, sobrescribiendo lo que hayas arrastrado.

Por lo tanto:

• Para la documentación sincronizada, cambia el orden en el <product-slug>-docs-manifest.json del producto y vuelve a sincronizar.
• Usa arrastrar y soltar para los documentos que no tienen fuente Markdown, donde nada lo sobrescribirá.

Encontrar cosas

La barra de herramientas ofrece:

• Búsqueda instantánea por título, slug, ruta de categoría, estado e ID de la publicación.
• Un filtro de estado, que enumera los estados realmente presentes.
• Una opción para ocultar las categorías sin documentos agrupados directamente debajo de ellas.
• Un recuento en vivo de los documentos visibles actualmente.

Pulsa / en cualquier lugar fuera de un campo de formulario para saltar al cuadro de búsqueda.

La barra lateral

La barra lateral izquierda refleja el árbol de categorías y resalta la sección que estás viendo mientras te desplazas, manteniendo la entrada activa a la vista. Seleccionar una categoría se desplaza suavemente hasta su sección.

Cada encabezado de categoría enlaza con su archivo público, para que puedas comprobar lo que ven los lectores.

Las tarjetas de documentos

Cada tarjeta muestra el estado del documento, el título, el ID, el slug, la fecha de modificación y las categorías asignadas, con las acciones habituales de editar y ver. Los borradores ofrecen una vista previa en lugar de un enlace público.

Revisar una rama de documentación

1. Borra la búsqueda y selecciona All statuses.
2. Localiza la categoría raíz del producto en la barra lateral.
3. Inspecciona cada tema hijo y confirma que los documentos están agrupados como se esperaba.
4. Usa el filtro de estado para revisar los borradores por separado.
5. Abre los archivos públicos de categorías y documentos representativos para verificar el resultado de cara al lector.
6. Para la documentación sincronizada, corrige la agrupación o el orden en el repositorio y vuelve a sincronizar.

Resultado esperado

Cada documento mantenido aparece una sola vez bajo su categoría más profunda prevista. Los borradores permanecen claramente marcados, los enlaces públicos abren los documentos publicados y el orden manual se guarda solo donde el manifiesto no lo sobrescribirá.

Solución de problemas

• El arrastre está desactivado: borra la búsqueda y restablece el filtro de estado a All statuses.
• Un documento aparece bajo la categoría equivocada: edita sus categorías asignadas o corrige su directorio de origen y vuelve a sincronizar.
• Un orden manual se revierte: el documento está sincronizado; actualiza el manifiesto del producto en su lugar.
• Falta un documento esperado: comprueba el filtro de estado, el texto de búsqueda y la papelera; después revisa el último resultado de sincronización.
• El árbol de categorías es demasiado disperso: desactiva Hide empty categories para mostrar la jerarquía completa.

Qué no hace

• No hay acciones masivas — usa la tabla de publicaciones estándar.
• No hay edición in situ.
• No hay creación en línea. Add document abre el editor normal.
• No se pueden mover documentos entre categorías.