En mi opinión, esto es un paso atrás con respecto al plugin original de Docs.
Discrepo totalmente. Nos da mucha más flexibilidad en cómo se ven nuestros documentos. Además, esto también hace posible enlazar a páginas de otras categorías, e incluso enlaces externos.
1 me gusta
Pero con miles de documentos y con otros nuevos que se añaden con frecuencia, esto lo convierte en una tarea muy manual.
2 Me gusta
De acuerdo, no sé si podría gestionar documentos de 1000 páginas con Discourse. Podría verme haciéndolo aunque haya soluciones de documentación más específicas… 1000 páginas sin git parece… también doloroso 
¿Por qué no? Funciona muy bien con los Documentos originales. Por ejemplo, tenemos temas en la categoría “Biblioteca” que contienen uno o más archivos PDF u otros adjuntos además del texto de la publicación. Cada tema también está etiquetado según corresponda, por lo que encontrar cosas es muy fácil con la búsqueda y el filtrado por etiquetas.
Quizás sea una cuestión de caso de uso. Quizás te adaptes a ello como resultado de usar Discourse como documentación desde el principio, pero en mi área (documentación técnica/de usuario) de todos modos necesitaría indexación manual.
He descubierto que para el mantenedor es muy fácil buscar y encontrar publicaciones.
Pero desde el punto de vista de un usuario que no conoce tu producto o es nuevo en el tema, es posible que no sepa qué buscar, en cuyo caso la estructuración tiene mucho sentido (en mi experiencia) o los usuarios se pierden en el laberinto de la documentación. Puedes probarlo tú mismo, piensa en 5 a 10 documentos aleatorios dentro de varias etiquetas que esperas que tus usuarios lean. Luego, intenta encontrarlos simplemente haciendo clic en tu sitio; si tienes problemas para encontrarlos tú mismo, puedes imaginar cómo sería la experiencia del usuario.
2 Me gusta
Encontrar cosas es fácil con el filtrado. Digamos que desea instrucciones de instalación del motor para el modelo de aeronave Glastar. No sabe exactamente qué buscar, pero los conceptos son fáciles de buscar y filtrar:
Con la antigua documentación, todo lo que pongo en la categoría Biblioteca se añade automáticamente a la documentación. No hay que mantener manualmente un índice separado, que es a lo que me opongo.
1 me gusta
Estoy de acuerdo en que el diseño actual no es ideal.
Necesitábamos flexibilidad y asumimos deuda técnica para conseguirla. Es la razón principal por la que consideramos que Discourse Doc Categories sigue siendo experimental.
Nuestra intención es diseñar y construir algo mejor aquí algún día, pero actualmente no es una prioridad.
5 Me gusta
Creo que el problema es que el plugin original que muchos sitios adoptaron e implementaron ampliamente ahora está marcado como end-of-life a pesar de no ofrecer un puente práctico hacia el nuevo.
Acabo de implementar algunas KM en un sitio utilizando el nuevo plugin, por lo que la experiencia está fresca en mi mente. Tener que curar un tema de índice para ver algo en la vista de documentos se siente realmente poco elegante. Implementar el plugin antiguo fue comparativamente sencillo, siempre que existiera una taxonomía de etiquetas decente.
Puedo entender que las nuevas necesidades impulsaron la creación de Discourse Doc Categories, pero por su propia admisión estamos atrapados entre un plugin experimental que no satisface las necesidades actuales y el plugin antiguo que tiene una vida útil finita.
7 Me gusta
Estoy totalmente de acuerdo con Stephen.
Me pregunto por qué se abordó como un plugin completamente nuevo en lugar de una evolución del original. Las revoluciones en el software pueden ser poderosas, pero funcionan mejor cuando son rápidas y decisivas.
3 Me gusta
En realidad, no estoy utilizando el plugin Docs para gestionar la documentación; solo necesito una interfaz sencilla para filtrar temas por varias categorías y varias etiquetas a la vez, todo en la misma página.
La interfaz predeterminada de Discourse requiere pasar por la Búsqueda Avanzada, que está demasiado oculta e incluye muchos filtros que no necesito (como autor o fecha). Busco una experiencia más enfocada y directa.
El antiguo plugin Docs me ayuda a lograr este filtrado de múltiples categorías y múltiples etiquetas, pero todavía tiene una limitación:
Cuando selecciono una categoría principal, solo muestra los temas directamente dentro de esa principal; no incluye los temas de sus subcategorías.
En contraste, la vista de categoría predeterminada muestra temas de la categoría principal y de las subcategorías.
Por eso sigo utilizando el plugin, aunque no sea ideal.
Aquí está mi solicitud anterior relacionada con esto: Multi menu select Group tags
Gracias de nuevo a todos los que han dedicado tiempo a discutir y ayudar a refinar esto; su apoyo y conocimiento son profundamente apreciados.
2 Me gusta