¿Cuál debería ser la página de inicio para las categorías de documentos?

Cuando haces clic en Documentation > Site Management, me pregunto si debería llevarte al índice en lugar de a los temas más recientes.

¿O tal vez debería llevarte a algún otro tema de “visión general” que especifiques?

Habíamos estado enlazando directamente al índice en las descripciones de las categorías para que fuera más fácil de descubrir:

discusión relacionada

¿O tal vez está bien como está? Quizás eso sea redundante dado que el índice ya está en la barra lateral, pero algo me parece un poco extraño sobre el diseño actual en dos aspectos:

  • el índice en sí puede ser difícil de encontrar
  • la lista de temas más recientes se siente un poco desorientadora en comparación con la forma en que funciona la navegación por la documentación una vez que estás en un tema determinado
4 Me gusta

Me pregunto si el índice ofrece una mejor entrada a la documentación. El problema que veo es que ni la página del índice ni la barra lateral facilitan realmente el escaneo y la navegación por los temas de la documentación:

¿No estoy seguro de si hay una solución obvia? Existen patrones para mejores diseños de barra lateral en plataformas de documentación existentes. ¿Pero estos mejorarían nuestro caso sin hacer más trabajo en la organización real de los temas? Podrían no funcionar bien para la wiki comunitaria en general.

¿Quizás una barra lateral derecha que tenga más un diseño de tabla de contenido, en lugar de la barra lateral izquierda estrecha actual, funcionaría mejor?

3 Me gusta

También lo he estado pensando, independientemente de meta.discourse.org, pero como una necesidad general para el plugin de categorías de documentación. Llegar a la página de índice es mucho mejor en muchos casos, y creo que aclararía el contenido de la barra lateral para los usuarios en comparación con llegar directamente a la categoría y probablemente no notar el cambio en la barra lateral hasta que entras en un tema.

Sería genial tener una opción en el plugin para habilitarlo en una categoría específica, de modo que en casos con listas increíblemente largas como se menciona aquí, podrías deshabilitarlo, pero en otros casos podrías habilitarlo.

He investigado un poco más hoy: estaba considerando si quería enviar una solicitud de extracción (pull request) para agregar una configuración al complemento. Cuando estuviera habilitada, esta configuración obligaría a que los enlaces directos a la categoría redirijan al navegador al índice de documentación de esa categoría. Mientras revisaba el trabajo existente sobre el complemento, me encontré con una reestructuración mucho más amplia de las funcionalidades que está en curso: FEATURE: Add visual doc category index editor by megothss · Pull Request #87 · discourse/discourse-doc-categories · GitHub

Parece que sería un momento excelente para agregar este tipo de funcionalidad opcional para usar el índice de documentación como listado de categorías. Al mismo tiempo, podría entrar en conflicto con un “Modo Simple” que @sam está desarrollando dentro de la actualización. Sam, ¿ves la opción que describí arriba como algo que podría encajar en tu trabajo sobre el Modo Simple o en el trabajo más amplio de la solicitud de extracción para ofrecer más opciones para construir el índice? Sería realmente genial poder elegir la configuración simplificada de columnas que estás desarrollando o simplemente usar el tema del índice. Quizás, idealmente, el contenido del post se muestre encima del listado completo, normal o simplificado de la categoría.

1 me gusta