O arquivo de ajuda (ou manual do usuário) está morto?[fechado]

Question

Na época do Unix, você não conseguia nem fechar um software sem ler a página de manual primeiro.Depois vieram o Mac e o Windows com layout de menu e atalhos de teclado consistentes, mas você ainda via manuais do usuário em papel enviados na caixa, que descreviam cada operação possível no aplicativo.Depois da Internet, os arquivos de ajuda tornaram-se documentos HTML.

Hoje em dia com Rede 2.0 aplicativos, você dificilmente verá a Ajuda.Até se estiver lá, eles simplesmente descrevem algumas tarefas específicas.Em outras palavras, os aplicativos estão confiando mais no senso comum ou não-me-faça-pensar fator da base de usuários.

Anos atrás, a Microsoft surgiu com um conceito chamado Interface de usuário indutiva, que basicamente diz aos programadores para inserirem instruções nos próprios aplicativos, mas não tenho certeza de quão popular essa ideia é.

Os arquivos de ajuda, manuais do usuário e ajuda on-line sensível ao contexto com a tecla F1 estão mortos?Eu falhei se o usuário não conseguiu descobrir o que fazer na interface do usuário?Se não, que grau de ajuda devo fornecer?(tanto para desktop quanto para aplicativos da web)

EDITAR:Como a documentação/arquivo de ajuda combina com métodos de desenvolvimento ágil?Por exemplo, os desenvolvedores deveriam pensar duas vezes antes de alterações na interface do usuário que possam tornar obsoletas um monte de capturas de tela?

Answer 1

Eu falhei se o usuário não conseguiu descobrir o que fazer na interface do usuário?Se não, que grau de ajuda devo fornecer?(tanto para desktop quanto para aplicativos da web)

Eles devem ser capazes de usar seu aplicativo para fazer coisas básicas na interface do usuário.por exemplo, digamos que para um editor de imagens, eles devem ser capazes de criar uma nova imagem, desenhar algumas linhas e salvá-la apenas olhando para a interface do usuário.

A melhor maneira de fazer isso é seguir layouts comuns (como abrir novo, abrir e salvar em arquivo na barra de menu e usar as caixas de diálogo padrão para abrir e salvar).

O mesmo vale para webapps, as pessoas esperam poder fazer as coisas básicas sem ter que ler os documentos, mas para recursos mais avançados as pessoas ainda lerão os documentos.(por exemplo, a maioria das pessoas lerá os documentos para, digamos, código BB ou descontos pelo menos às vezes, mas esperam poder postar sem precisar conhecê-los)

Os arquivos de ajuda, manuais do usuário e ajuda on-line sensível ao contexto com a tecla F1 estão mortos?

Eles ainda têm seu lugar.As pessoas os usarão para aprender como usar melhor vários recursos, por exemplo, markdown ou bbcode, ou como usar filtros para obter determinados efeitos em um editor de imagens.

Answer 2

Três notas sobre ajuda:

1. A ajuda sensível ao contexto F1/autônoma sempre esteve condenada.Ele estava oculto por padrão e, portanto, as pessoas que mais precisavam dele tinham menos probabilidade de lê-lo.Houve uma esperança de que seríamos capazes de treinar os usuários para sempre acertar F1 quando enfrentassem problemas, mas muitos aplicativos sem ajuda útil sensível ao contexto...combinado com muitas interfaces de ajuda bizarras...praticamente matou isso.
2. Os manuais são tão importantes agora como sempre foram.Não há mais tantos manuais impressos, mas os manuais online estão melhores do que nunca.A proliferação de sistemas wiki como manual ajudou aqui, reduzindo o custo inicial da criação de boa documentação online.Claro, muitas pessoas só não leia...
3. A beleza de usar páginas da web como interface de aplicativo é que você pode combine ajuda útil sensível ao contexto com a interface do usuário, removendo a barreira para novatos e outras pessoas que, de outra forma, não se dariam ao trabalho de procurar informações relevantes quando ficassem presos.

É claro que ainda existem muitos aplicativos, até mesmo aplicativos on-line, projetados com interfaces obtusas e um pequeno ícone de ajuda em algum canto, provavelmente esperando que o último mitigue o primeiro.Tenha pena deles.

Answer 3

Sem chance.Você olha para a quantidade de documentação, treinamento e despesas de marketing que até a MS oferece.você obterá sua resposta.Tente usar o produto de outra pessoa e você aprenderá o verdadeiro valor da documentação - estou aprendendo Godiagramas agora.:)
Então posso dizer sem dúvida.. NÃO e nunca será..não importa o quão intuitivas as interfaces de usuário sejam.além de um determinado tamanho, você precisará de ajuda e treinamento. Mas ao entender o usuário e o que ele precisa fazer, você pode projetá-lo de forma que o tempo que ele precisa para aprender o sistema a realizar suas tarefas rotineiras seja mínimo.

Answer 4

Tenho incorporado screencasts sensíveis ao contexto em meus aplicativos.Descobri que isso ajuda usuários não técnicos a entender o aplicativo rapidamente, sem precisar de ajuda ao vivo.

Answer 5

Os livros Idiota/Idiota devem estar indo muito bem.Imagine se a ajuda padrão do aplicativo fosse tão boa quanto esses livros.A ajuda padrão da F1 para muitos aplicativos é simplesmente horrível.

A ajuda está morta?Não, mas parte dela deveria ser retirada e fuzilada.