widgets textoutput inputs example app user-interface language-agnostic documentation

user-interface - inputs - textoutput shiny example



¿Está muerto el archivo de ayuda(o el manual del usuario)? (5)

En los días de Unix, ni siquiera podías cerrar un software sin leer primero la página del manual. Luego vinieron Mac y Windows con un diseño de menú consistente y atajos de teclado, pero aún veía manuales en papel enviados en la caja de contracción, que describía todas y cada una de las operaciones posibles en la aplicación. Después de Internet, los archivos de ayuda se convirtieron en documentos html.

Hoy en día con las aplicaciones Web 2.0 , apenas ves la Ayuda. Incluso si está allí , simplemente describen algunas tareas específicas. En otras palabras, las aplicaciones se basan más en el sentido común o en el factor " don''t-make-me-think de la base de usuarios.

Hace años, Microsoft creó un concepto llamado interfaz de usuario inductivo , que básicamente les dice a los programadores que envíen instrucciones sobre las aplicaciones en sí, pero no estoy seguro de qué tan popular es esa idea.

¿Los archivos de ayuda, los manuales de usuario y la ayuda contextual en línea ayudan con la tecla F1 muerta? ¿Fallé si el usuario no pudo encontrar qué hacer desde la interfaz de usuario? Si no, ¿qué grado de ayuda debería brindar? (tanto para aplicaciones de escritorio como web)

EDITAR: ¿Cómo se combina la documentación / archivo de ayuda con los métodos de desarrollo ágiles? Por ejemplo, ¿deberían los desarrolladores pensar dos veces antes de los cambios de la interfaz de usuario que pueden obsoletos un montón de capturas de pantalla?


¿Fallé si el usuario no pudo encontrar qué hacer desde la interfaz de usuario? Si no, ¿qué grado de ayuda debería brindar? (tanto para aplicaciones de escritorio como web)

Deben poder usar su aplicación para hacer cosas básicas desde la interfaz de usuario. por ejemplo, digamos que para un editor de imágenes, deberían poder crear una nueva imagen, dibujar algunas líneas y luego guardarla simplemente mirando la interfaz de usuario.

Esto se hace mejor siguiendo diseños comunes (como tener nuevos, abrir y guardar debajo de un archivo en la barra de menú, y usar los diálogos estándar de abrir y guardar).

Lo mismo ocurre con las aplicaciones web, las personas esperan poder hacer las cosas básicas sin tener que leer los documentos, pero para obtener funciones más avanzadas, las personas seguirán leyendo los documentos. (Por ejemplo, la mayoría de la gente leerá los documentos para decir, por ejemplo, código BB, o rebaja al menos algunas veces, pero esperan poder publicar sin tener que conocerlos)

¿Los archivos de ayuda, los manuales de usuario y la ayuda contextual en línea ayudan con la tecla F1 muerta?

Ellos todavía tienen su lugar. La gente los usará para aprender cómo usar mejor varias características, por ejemplo, markdown o bbcode, o cómo usar filtros para obtener ciertos efectos en un editor de imágenes.


Tres notas sobre ayuda:

  1. F1 / la ayuda contextual independiente siempre estaba condenada. Estaba oculto por defecto, por lo que las personas que más lo necesitaban tenían menos probabilidades de leerlo. Hubo una vez la esperanza de que pudiéramos capacitar a los usuarios para que siempre golpeen la F1 cuando tuvieron problemas, pero demasiadas aplicaciones sin ayuda contextual sensible ... combinadas con demasiadas interfaces de ayuda extrañas ... casi matado esta.
  2. Los manuales son tan importantes ahora como lo fueron alguna vez. Ya no hay tantos manuales impresos, pero los manuales en línea son mejores que nunca. La proliferación de sistemas de wiki como manual ha ayudado aquí, reduciendo el costo inicial de crear una buena documentación en línea. Por supuesto, muchas personas simplemente no leen ...
  3. La belleza del uso de páginas web como interfaz de aplicación es que puede combinar la ayuda contextual sensible con la interfaz de usuario, eliminando la barrera para los principiantes y otros que de lo contrario no podrían molestarse en buscar información relevante cuando se estanquen.

Por supuesto, todavía hay muchas aplicaciones, incluso aplicaciones en línea, diseñadas con interfaces obtusas y un pequeño ícono de ayuda en un rincón en algún lugar, presumiblemente con la esperanza de que este último mitigue el primero. Pity ellos.


De ninguna manera. Mire la cantidad de documentación, capacitación y gastos de mercadotecnia que incluso la MS pone arriba ... obtendrá su respuesta. Intenta usar el producto de otra persona, y aprenderás el verdadero valor de la documentación. Estoy aprendiendo Godiagrams en este momento ... :)
Así que puedo decir sin lugar a dudas ... NO y nunca lo hará ... no importa cuán intuitivas sean las interfaces de usuario ... más allá de un cierto tamaño, necesitarás ayuda y capacitación. Pero al comprender al usuario y lo que necesita hacer, puede diseñarlo de forma tal que el tiempo que necesita para aprender el sistema para realizar sus tareas rutinarias sea mínimo.


He estado incorporando screencasts sensibles al contexto en mis aplicaciones. Descubrí que esto ayuda a los usuarios no técnicos a comprender la aplicación rápidamente, sin pedir ayuda en vivo.


Los libros Idiot / Dummy deben estar funcionando bastante bien. Imagine si la ayuda estándar de la aplicación fuera tan buena como esos libros. La ayuda estándar de F1 para muchas aplicaciones es simplemente horrible.

¿La ayuda está muerta? No, pero parte de ella debería ser retirada y disparada.