Documentación: Consejos y trucos para usar la búsqueda

Primero, algunos metadatos generales :wink:

En mi foro utilicé una buena cantidad de categorías. Principalmente porque tenía la misma estructura en otros sitios y todo el mundo hace lo mismo. Pero como todo el mundo sabe, o debería saber, una gran cantidad de categorías y muchos subcategorías, además de todas las sub-subcategorías, son casi imposibles de manejar. Y lo más importante: las categorías no ayudan al usuario a encontrar contenido relevante.

En realidad, nada nuevo. Esa es una razón por la que Discourse solo admite categorías de dos niveles y el uso de etiquetas se recomienda con frecuencia.

Sin embargo, bastantes personas están en contra de las etiquetas. Supongo que conduce a un uso indebido generalizado de las etiquetas en otras plataformas, mezclándolas con palabras clave (en parte, las etiquetas y las palabras clave son lo mismo) y el abuso de hashtags por parte de Instagram, etc. Además… el punto de vista común es que, debido a esa historia, los usuarios comunes no saben cómo usar las etiquetas.

Pueden. Para ellos, lo que ven en la pantalla, las etiquetas son lo mismo que las categorías, pero dan mejores resultados (SI las usan correctamente los administradores).

Pero las etiquetas funcionan mejor con las búsquedas. Y eso también es un problema. Como las etiquetas se usan indebidamente de forma generalizada, también lo son las búsquedas, porque simplemente no funcionan. Los usuarios han aprendido a no usar la búsqueda, porque arroja demasiados resultados. Es una lucha interminable entre las habilidades de los usuarios, si se deben mostrar todos los resultados a un usuario o si podemos usar alguna suposición como hace Google.

Ese es un problema que los desarrolladores deben resolver. Pero esa es otra historia.

De todos modos. Mi audiencia son gente común, nada experta en tecnología. Tienen dificultades para empezar a usar el editor de Discourse y no podían cambiar el tema. Claro, ahora pueden, en su mayoría, pero necesitó mucha orientación.

Pero se adaptaron a la falta de categorías y comenzaron a usar etiquetas de inmediato. Para ellos fue un acto realmente intuitivo. O como dijeron un par de usuarios: hacer clic en las etiquetas es como buscar, pero mejor. Todo lo que tuve que hacer a nivel de orientación fue decirles que hicieran clic en las etiquetas y descubrieran qué sucede y dónde lleva Etiquetas en la hamburguesa.

Volviendo al negocio

Discourse tiene uno de los mejores motores de búsqueda en el mundo web gratuito. No es perfecto, por supuesto, pero es muy superior a la búsqueda nativa de WordPress u otros CMS (si no conoce el plugin de búsqueda de WordPress Relevantti, debería echarle un vistazo; es bastante bueno).

Ahora estoy enseñando a mis usuarios cómo mejorar los resultados de búsqueda. De hecho, incluso esa fue una tarea mucho más fácil de lo que esperaba, y esos usuarios casi nunca usan la búsqueda en ningún lado (no los culpo, porque las búsquedas apestan con tanta frecuencia).

Pero ahora me faltan algunas referencias. Sé que Discourse puede usar muchos trucos directamente en los términos de búsqueda, pero esos fragmentos y pedazos de conocimiento están dispersos en… muchas publicaciones y temas.

Lo sé: escribir documentación y consejos y trucos requiere más trabajo que la codificación en sí. He hecho mucha documentación. No se trata solo de escribir una, sino de que debe haber al menos tres documentos diferentes según la necesidad y las habilidades de los usuarios. Además, alguien debería mantenerlos actualizados también.

Es por eso que entiendo totalmente que no podría encontrar una guía abrumadora para dominar las búsquedas en Discourse :wink: (o simplemente… no puedo buscar)

Lo que le pido a la comunidad es

  • una lista simple de (o de; a veces odio tanto el inglés) parámetros de búsqueda o simplemente ejemplos/enlaces
  • enseñe a sus usuarios a usar la búsqueda, la mayoría simplemente no pueden
  • elimine las categorías y comience a usar etiquetas en su lugar (bueno, requiere algo de planificación para hacerlo bien, sin embargo)
6 Me gusta

Muy de acuerdo. Hay 2 excelentes plugins que también pueden mejorar la experiencia del usuario con las búsquedas.

  • Búsquedas Guardadas
  • Documentos

Sin embargo, sí, configurar guías del foro es un requisito indispensable para ayudar a los usuarios a utilizar mejor un foro y mejorar su experiencia. Ahí es donde el plugin de Documentos puede ser definitivamente un activo. También hay un componente temático que se puede utilizar con el plugin de documentos.

1 me gusta

@hugh / @JammyDodger, ¿necesitamos algo como esto en el tema de la documentación?

3 Me gusta

Existe Searching for content effectively

4 Me gusta

Genial, he integrado todo (usando el claude-3.5-sonnet) y estoy contento con la edición, pero siéntete libre de revisarla.

4 Me gusta

Eliminé la mayoría porque:

Me gusta que el tema resalte los filtros que no puedo descubrir usando la búsqueda avanzada. Si quieres cambiar el alcance, simplemente revierte la edición.

Dejé las opciones de orden porque esas no se muestran en el campo de entrada de búsqueda, por lo que es más difícil usarlas sin el menú desplegable.

1 me gusta

Creo que es mejor cambiar el alcance… esta regla se siente muy arbitraria. ¿Quizás simplemente eliminamos “Este tema tiene como objetivo enumerar otros filtros que no están disponibles en el formulario de búsqueda avanzada”?

@JammyDodger ¿qué opinas?

Entiendo que puedes descubrir mucho haciendo clic, pero la documentación te ahorra eso. Además, esta edición empeora la búsqueda.

Por ejemplo:

búsqueda de seguimiento ya no encontrará este documento, lo cual es una pena.

3 Me gusta