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:
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.
#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.
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.
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).
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
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 .
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.
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.
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í.