Las categorías de documentación están diseñadas para un tipo específico de contenido: material de referencia al que los lectores vuelven, escanean rápidamente y al que enlazan con frecuencia. Para apoyar esto, estamos introduciendo un nuevo modo simple para el plugin Categorías de documentación de Discourse, que ofrece a la documentación una experiencia centrada en la lectura, manteniendo el tema completo disponible con un solo clic.
Una vista de tema centrada en la lectura
Cuando el modo simple está activado, al abrir un tema de documentación, el documento en sí queda en primer plano. Las respuestas permanecen a un clic de distancia, detrás de un interruptor en la publicación original (OP):
Mostrar 12 comentarios / Ocultar comentarios
Haz clic y aparecerá toda la discusión en su lugar habitual, ordenada y renderizada exactamente como siempre. Haz clic de nuevo para contraerla.
Algunos detalles que vale la pena mencionar:
- Enlazar directamente a una respuesta (
/t/slug/id/4) expande automáticamente el tema, de modo que cualquier persona que llegue desde un enlace compartido o una notificación aterrice en la publicación a la que fue enviada. - Las nuevas respuestas que llegan mientras el tema está contraído se suman al texto del interruptor, por lo que puedes ver de un vistazo cuándo ha llegado algo nuevo.
Una lista de temas con forma de documentación
Dentro de una categoría de documentación, la lista de temas también se simplifica: las columnas se centran en el título y en cuándo se actualizó por última vez, con la columna Actividad mostrándose como Actualizado. Los lectores pueden escanear los títulos y detectar rápidamente lo que es nuevo.
El resultado se asemeja más a una base de conocimientos: una lista limpia de artículos, cada uno a un clic de distancia.
Actívalo en tu sitio
El modo simple se lanzará como un cambio próximo experimental. Ve a la página de cambios próximos en tu área de administración (/admin/config/upcoming-changes) y busca Modo simple de categorías de documentación para activarlo.
El cambio solo se aplica a los temas dentro de categorías configuradas como categorías de documentación, por lo que el resto de tu sitio no se ve afectado.
Nos encantaría recibir tus comentarios
El modo simple está en etapas tempranas y esperamos seguir iterando. Si lo activas para tu documentación, por favor comparte qué está funcionando, qué sientes que falta y cualquier problema que encuentres. Tus comentarios darán forma a los siguientes pasos.