Esta guía de estilo se centra en crear descripciones de página efectivas y descripciones emergentes para la interfaz de usuario de un producto. Ambos elementos son cruciales para proporcionar claridad y contexto, ayudando a los usuarios a navegar e interactuar con la plataforma de forma eficiente.
Principios fundamentales
| Principio | Qué significa |
|---|---|
| Claridad y simplicidad | Utiliza un lenguaje directo, libre de jerga y complejidad técnica. Mantén los mensajes cortos y directos. |
| Consistencia | Utiliza una terminología coherente en todas las descripciones y descripciones emergentes. Sigue el mismo tono, tenso y estilo a lo largo de toda la plataforma. |
| Lenguaje centrado en el usuario | Escribe desde la perspectiva del usuario, enfatizando acciones o beneficios. Evita los términos internos del sistema a menos que sean orientados al usuario. |
| Accesibilidad | Asegúrate de que el texto sea comprensible para todos los usuarios, incluidos los no nativos. Usa el caso de la oración para mayor legibilidad. |
Descripciones de las páginas
Una descripción de la página ofrece una breve explicación del propósito de la página y ayuda a los usuarios a comprender las acciones clave que pueden realizar allí.
Mejores prácticas
| Directriz | Qué hacer |
|---|---|
| Resume el propósito de la página | Céntrate en lo que los usuarios pueden lograr en la página. |
| Longitud límite | Quédate con 1 o 2 frases. Evita descripciones demasiado detalladas. |
| Utiliza lenguaje orientado a la acción | Comienza con verbos o frases que describan lo que el usuario puede hacer. |
| Evita la repetición | No repitas el título de la página ni dupliques otros elementos de la interfaz. |
Ejemplos
| Página | Descripción |
|---|---|
| Página de gestión de categorías | "Organiza y gestiona las categorías de tu base de conocimiento para estructurar tu contenido de forma eficaz." |
| Página de subida de archivos | "Sube archivos para adjuntarlos a artículos o compartirlos con tu equipo." |
| Página de configuración de permisos | "Definir permisos de acceso para grupos de lectores para controlar la visibilidad del contenido." |
Descripciones emergentes
Una descripción emergente proporciona contexto adicional o aclaraciones sobre un elemento específico de la interfaz cuando los usuarios pasan el cursor sobre él.
Mejores prácticas
| Directriz | Qué hacer |
|---|---|
| Sé conciso | Limita las descripciones a una frase corta (menos de 15 palabras). |
| Añade valor | Proporciona información que no sea visible inmediatamente en la interfaz. No repitas etiquetas o descripciones que ya están claras. |
| Usa el presente | Concéntrate en el estado actual o la acción disponible para el usuario. |
| Sé específico | Adapta las descripciones emergentes a la funcionalidad del elemento. Evita frases vagas o genéricas. |
Ejemplos
| Elemento | Descripción emergente |
|---|---|
| Campo de dominios permitidos | "Introduce dominios para permitir que usuarios con direcciones de correo electrónico coincidentes se registren." |
| Botón de exportar | "Descarga los datos actuales como archivo CSV." |
| Configuración SEO | "Optimiza tu artículo para los motores de búsqueda añadiendo una metadescripción y palabras clave." |
Descripciones de páginas vs. descripciones emergentes
| Aspecto | Descripciones de las páginas | Descripciones emergentes |
|---|---|---|
| Propósito | Proporciona un resumen del propósito de la página. | Ofrece orientación adicional para elementos específicos de la interfaz. |
| Ubicación | Debajo del título o encabezado de la página. | Aparece al pasar el cursor sobre un elemento específico. |
| Longitud | 1–2 frases. | Una frase corta o una sola frase. |
| Tono | Neutral y explicativo. | Contextual e instructivo. |
Lista de comprobación: Descripciones de las páginas
- ¿Explica claramente el propósito de la página?
- ¿Es corto y fácil de leer?
- ¿Guía al usuario sobre lo que puede lograr en la página?
- ¿Evita redundancia con otros elementos de la interfaz?
Lista de comprobación: Descripciones
- ¿Aporta valor más allá de lo visible en la interfaz?
- ¿Es conciso y específico para cada elemento, sin resultar abrumador?
- ¿Usa el presente?
- ¿Evita repetir la etiqueta o el título del elemento?
- ¿Está libre de jerga o terminología complicada?
- ¿Es gramaticalmente correcto y está puntuado correctamente?