¿Hacer que los Docs sean más visibles en el foro?

He sido miembro de este foro durante años, pero nunca uso Documentation - Discourse Meta porque olvido que existe.

Incluso una vez pensé: “sería genial si hubiera un enlace a Docs en la navegación superior…” y luego me di cuenta de que ya existe:

image

Por alguna razón, mi cerebro lo ignoró por completo.

Además, el enlace de la barra lateral está oculto al final del menú Más, que creo (sin datos que respalden este pensamiento) que muy pocas personas hacen clic.

También me pregunté si algún icono junto al botón de navegación de Docs ayudaría a mi cerebro a notarlo.

image

¿Y qué hay de ponerlo junto al logo en el encabezado? ¿Quizás dos enlaces? ¿Uno para Documentation - Discourse Meta, otro para https://docs.discourse.org/?

Además, algo me molesta:

  • Docs es meta documentación

  • Discourse Docs es el plugin.

  • #docs es la etiqueta relacionada con el plugin.

  • Los enlaces image y image llevan a Docs

  • #documentation es una categoría no relacionada directamente con Docs.

  • docs.discourse.org es la documentación de la API.

Un poco confuso, ¿verdad?

Dicho esto, el punto principal es que siempre olvidé que existe Documentation - Discourse Meta, y por eso, nunca lo uso. Lo más cercano que hago es usar la búsqueda, comenzando con #documentation.

7 Me gusta

Como un extra, también puedes usar el filtro in:docs en tu búsqueda. :+1:

4 Me gusta

¡Yo también!

Asumí que esto era una broma. Recientemente me lamenté de que NO HABÍA MANERA DE ENCONTRAR LA DOCUMENTACIÓN. Pero, esto no es una broma. Está ahí mismo. Claramente.

Esto también parece cierto, excepto que el otro día lo busqué y pensé que no podía encontrarlo allí, o tal vez simplemente pensé que no necesitaba estar tan oculto.

No estoy seguro de si este es un caso de UX o de que puedes llevar un caballo al agua.

1 me gusta

Creo que una pequeña parte del problema, algo que @chapoi mencionó en algún momento en el pasado, es que este menú no está realmente supuesto a ser un menú de navegación… es un menú de filtro al que hemos agregado un par de enlaces de navegación (categorías y documentación).

Screenshot 2023-05-16 at 12.30.08 PM

Probablemente tendría más sentido que la documentación residiera en la sección “comunidad” de la barra lateral junto con otros enlaces de navegación (no en el cajón). Sin embargo, esto podría hacerla menos visible si alguien no usa la barra lateral, así que si el enlace de documentación necesita ser más obvio, también podríamos destacarlo en otro lugar :thinking:

5 Me gusta

Prácticamente ninguno de mis usuarios móviles habituales usa la barra lateral. No hay nada que sientan que necesiten. Y… en realidad los entiendo.

3 Me gusta

Creo que este es un caso de “sí, y…”

Tenemos la documentación enlazada en tres lugares, de hecho:

  • banner para usuarios nuevos y anónimos
  • encabezado del filtro en la parte superior
  • barra lateral

Mi sugerencia sería mover la documentación “above the fold” (visible sin hacer scroll) en la barra lateral, para que aparezca debajo de Temas. También darle algún tipo de glifo de libro :open_book:.

También añadir una referencia en New to Discourse? Start here!, que está fijado y esperamos que la gente lea al unirse a meta.

1 me gusta

Acabo de añadir Docs a la primera parte del menú, bajo Temas, para ver cómo quedaría. ¡Me gusta!

Sin embargo, no veo cómo eliminar el otro enlace que se añade automáticamente al final de esta lista. Probablemente necesitaría un cambio en el plugin para dejar de mostrarlo automáticamente o hacerlo configurable.

3 Me gusta

Con disculpas por la triple publicación… la eliminé nuevamente de la barra lateral para evitar la doble lista de documentos. Estamos trabajando en una solución para permitir la personalización de los elementos de la barra lateral para los complementos, lo que nos ayudará aquí.

1 me gusta