Las descripciones de las etiquetas ya no se muestran fuera de la página de etiquetas desde #42005

[thoka (Thomas Kalka)]

Claude redactó este informe de un bug para un caso para el que acabamos de escribir una solución alternativa:

Desde #42005 (“A11Y: don’t use the title attribute for category and tag descriptions”, julio de 2026), las descripciones de las etiquetas ya no tienen un lugar visible en la interfaz de usuario principal.

Pasos para reproducir

1. Asigna una descripción a una etiqueta, por ejemplo, Kreiselternrat para la etiqueta KER.
2. Abre /latest, /categories, un tema con esa etiqueta o el selector de etiquetas en el compositor.
3. Pasa el cursor o enfoca la etiqueta.

Esperado: alguna forma accesible de leer la descripción, como antes del cambio (donde era el tooltip del atributo title).

Actual: nada. La descripción solo aparece en /tag/ y en /tags.

Por qué creo que esto es un bug y no solo una decisión de diseño

El PR afirma que la información “ya está disponible en el tema ‘acerca de esta categoría’, en los menús desplegables de categorías y en los encabezados de categorías”. Esto se cumple para las categorías. No se cumple para las etiquetas: no hay un tema “acerca de”, las filas del selector de etiquetas no la muestran y la lista de temas tampoco la muestra.

Los datos todavía se envían al cliente y se pasan al renderizador, que simplemente los ignora:

• defaultRenderTag en frontend/discourse/app/lib/render-tag.js recibe params.description (lista de temas, título del tema, búsqueda a través de tags_descriptions) y lo descarta.
• frontend/discourse/select-kit/components/tag-row.gjs pasa description=this.item.description a dDiscourseTag, y también se descarta.

Estoy de acuerdo en que el atributo title es la herramienta incorrecta. El propio PR sugiere usar un tooltip/toggletip accesible en su lugar. Discourse tiene DTooltip en float-kit, que funciona al pasar el cursor y al enfocar con el teclado. ¿Podrían las etiquetas (y las filas del selector de etiquetas) usar eso, quizás detrás de una configuración del sitio?

Solución alternativa para cualquiera que la necesite ahora: un pequeño componente de tema que hace exactamente eso con api.replaceTagRenderer y el servicio de tooltip de float-kit, al pasar el cursor y al enfocar con el teclado: GitHub - thoka/discourse-tag-description-tooltip: Discourse theme component: show the tag description in a tooltip on hover and focus · GitHub

[awesomerobot (Kris)]

No es un error, al menos según cómo definimos los errores. En general, consideramos errores cuando una funcionalidad no funciona como se pretendía, y estos fueron cambios intencionados. En este caso es más bien un problema de UX.

@thoka

la lista de temas no lo muestra

La información está disponible en las listas de temas, de una manera accesible y accesible para todos:

Es más difícil de encontrar, y si hay un interés generalizado en hacer las descripciones más visibles, es una solicitud de función que podemos considerar.

También proporcionamos el componente Tag Banners, que coloca las descripciones en un banner en las listas de temas de las etiquetas.

Las sugerencias sobre las etiquetas no son realmente algo que podamos implementar bien como una opción, porque tienen un problema similar al del atributo title con la asimetría de datos… las sugerencias al pasar el cursor funcionan bien en el escritorio, pero no funcionan en dispositivos móviles, especialmente considerando que las etiquetas suelen ser enlaces, por lo que ya está asignado a la activación por clic.