Directrices para la ayuda de la aplicaciónGuidelines for app help

Las aplicaciones pueden ser complejas, por lo que proporcionar una ayuda eficaz a los usuarios puede mejorar enormemente su experiencia.Applications can be complex, and providing effective help for your users can greatly improve their experience. No todas las aplicaciones necesitan proporcionar ayuda para los usuarios y el tipo de ayuda puede variar mucho en función de la aplicación.Not all applications need to provide help for their users, and what sort of help should be provided can vary greatly, depending on the application.

Si decides ofrecer ayuda, sigue estas directrices al crearla.If you decide to provide help, follow these guidelines when creating it. Es preferible nu ofrecer ninguna antes que proporcionar una ayuda que no sirva para nada.Help that isn't helpful can be worse than no help at all.

Diseño intuitivoIntuitive Design

El contenido de la ayuda es muy útil, pero tu aplicación no puede depender de ella para proporcionar una buena experiencia para el usuario.As useful as help content can be, your app cannot rely on it to provide a good experience for the user. Si este no puede detectar y usar inmediatamente las funciones fundamentales de la aplicación, no la usará.If the user is unable to immediately discover and use the critical functions of your app, the user will not use your app. No importa la cantidad o calidad de la ayuda que proporciones, no cambiarán esa primera impresión.No amount or quality help will change that first impression.

Un diseño intuitivo y fácil de usar es el primer paso para crear una ayuda útil.An intuitive and user-friendly design is the first step to writing useful help. No solo mantendrá a los usuarios en la aplicación el tiempo suficiente como para que usen características más avanzadas, si no que además les proporcionará conocimientos sobre las funciones principales de la aplicación, que podrán desarrollar a medida que aprendan mediante su uso.Not only does it keep the user engaged for long enough for them to use more advanced features, but it also provides them with knowledge of an app's core functions, which they can build upon as they continue to use the app and learn.

Instrucciones generalesGeneral instructions

Un usuario no buscará en el contenido de ayuda a menos que ya tenga un problema, de modo que la ayuda debe proporcionar una respuesta rápida y eficaz.A user will not look for help content unless they already have a problem, so help needs to provide a quick and effective answer to that problem. Si no es útil de manera inmediata o es demasiado complicada, lo más probable es que los usuarios la pasen por alto.If help is not immediately useful, or if help is too complicated, then users are more likely to ignore it.

Toda ayuda, independientemente del tipo, debe seguir estos principios:All help, no matter what kind, should follow these principles:

  • Fácil de entender: La ayuda que confunde al usuario es peor que ninguna ayuda.Easy to understand: Help that confuses the user is worse than no help at all.

  • Simple Los usuarios que buscan ayuda quieren encontrar claras respuestas.Straightforward: Users looking for help want clear answers presented directly to them.

  • Apropiadas Los usuarios no quieren tener que buscar su problema específico.Relevant: Users do not want to have to search for their specific issue. Quieren que se les presente directamente la ayuda apropiada (esto se denomina "ayuda contextual") o una interfaz fácil de navegar.They want the most relevant help presented straight to them (this is called "Contextual Help"), or they want an easily navigated interface.

  • Directo Cuando un usuario busca ayuda, desea ver la ayuda.Direct: When a user looks for help, they want to see help. Es decir, si la aplicación incluye páginas de informes de errores, comentarios, condiciones del servicio o funciones similares, es adecuado que la ayuda contenga vínculos a esas páginas,If your app includes pages for reporting bugs, giving feedback, viewing term of service, or similar functions, it is fine if your help links to those pages. pero deberían incluirse de manera adicional en la página principal de ayuda y no como elementos de igual o mayor importancia.But they should be included as an afterthought on the main help page, and not as items of equal or greater importance.

  • Ajusta Independientemente del tipo, la ayuda sigue siendo una parte de la aplicación y debe tratarse como cualquier otra parte de la interfaz de usuario.Consistent: No matter the type, help is still a part of your app, and should be treated as any other part of the UI. Los mismos principios de diseño, facilidad de uso, accesibilidad y estilo que se usan en el resto de la aplicación también deben estar presentes en la ayuda que se ofrece.The same design principles of usability, accessibility, and style which are used throughout the rest of your app should also be present in the help you offer.

Tipos de ayudaTypes of help

Hay tres categorías principales de ayuda, cada una con varios niveles y adecuada para objetivos distintos.There are three primary categories of help content, each with varying strengths and suitable for different purposes. Usa la combinación más adecuada para las necesidades de tu aplicación.Use any combination of them in your app, depending on your needs.

Interfaz de usuario informativaInstructional UI

Normalmente, los usuarios deberían poder usar todas las funciones principales de la aplicación sin instrucciones.Normally, users should be able to use all the core functions of your app without instruction. Sin embargo, en ocasiones la aplicación dependerá del uso de gestos específicos o es posible que haya características secundarias de la aplicación que no sean perceptibles de manera inmediata.But sometimes, your app will depend on use of a specific gesture, or there may be secondary features of your app which are not immediately obvious. En estos casos, se debe usar la interfaz de usuario informativa para enseñar a los usuarios mediante instrucciones cómo realizar tareas específicas.In this case, instructional UI should be used to educate users with instructions on how to perform specific tasks.

Vea instrucciones para la interfaz de usuario de instruccionesSee guidelines for instructional UI

Ayuda desde la aplicaciónIn-app help

El método estándar para presentar ayuda es mostrándola en la misma aplicación cuando el usuario lo solicite.The standard method of presenting help is to display it within the application at the user's request. Hay varias maneras para implementar esto, por ejemplo, en las páginas de ayuda o en descripciones informativas.There are several ways in which this can be implemented, such as in help pages or informative descriptions. Este método es ideal para obtener ayuda de propósito general, que responde directamente preguntas de los usuarios sin complejidad.This method is ideal for general-purpose help, that directly answers a user's questions without complexity.

Consulte las instrucciones para la ayuda en la aplicaciónSee guidelines for in-app help

Ayuda externaExternal help

Para obtener tutoriales detallados, funciones avanzadas o bibliotecas de temas de ayuda que son demasiado grandes para la aplicación, lo mejor es incluir vínculos a páginas web externas.For detailed tutorials, advanced functions, or libraries of help topics too large to fit within your application, links to external web pages are ideal. Estos vínculos deben usarse con moderación si es posible, ya que alejan al usuario de la experiencia de la aplicación.These links should be used sparingly if possible, as they remove the user from the application experience.

Consulte las instrucciones para obtener ayuda externaSee guidelines for external help