Qual é o negócio com helpfiles nos dias de hoje?

Question

Eu adicionei esta questão em SuperUser para a perspectiva do usuário.

Então eu criar um aplicativo no Delphi ou .NET que será executado em um sistema desktop. Alguns GUI agradável com todos os tipos de funcionalidade e características interessantes. Ele funciona bem, os testes me diga que é quase livre de bugs e eu estou prestes a implantá-lo ...

Espere! Ela precisa de um arquivo de ajuda, assim os usuários podem recorrer a ajuda sensível ao contexto da aplicação!

Ou não? São helpfiles realmente um requisito para aplicações desktop estes dias? E eles realmente precisam ser sensíveis ao contexto, segurando as mãos do usuário para dizer-lhes que têm de preencher o seu dia de nascimento neste campo "Dia de nascimento"? Ou helpfiles se tornando um pouco antiquado?

Este é algo que eu perguntar sobre e isso é um pouco subjetivo, então ao invés disso eu vou pedir algo diferente, a todos vocês que desenvolvem aplicativos de desktop: Você helpfiles (ainda) oferta sensível ao contexto?

Sim ou não, por favor. Sinta-se livre para adicionar alguns textos subjetivo, mas para mim, o que importa é saber se os desenvolvedores modernos ainda estão adicionando a ajuda sensível ao contexto para suas aplicações GUI.

(Btw, eu me mudaram para arquivos PDF não de contexto que podem ser impressos como manual. É muito mais fácil de manter.)

Answer 1

Sim, eu faço.

Motivo: Eu simplesmente não pode esperar que o usuário saiba como o programa funciona. Ok, descrevendo o que tem de ser imputados em um campo de "Dia de nascimento" é um pouco extrem, mas há coisas normalmente mais complexo em um sistema de software. Eu tinha que escrever um arquivo de ajuda para o nosso sistema de contabilidade analítica apenas hoje, descrevendo como o sistema para determinar o preço que deve ser usado para os trabalhos de cálculo. Eu não acho que qualquer usuário poderia saber como configurar o sistema withoug este arquivo de ajuda.

Answer 2

Falando como um usuário, não um desenvolvedor -. Sim, eu quero um arquivo de ajuda sensível ao contexto

Por exemplo - Atualmente estou avaliando controles 3rd party para inclusão em um novo projeto. Os controles que têm boa ajuda sensível ao contexto (ou seja, você pode selecionar uma propriedade na janela de propriedades, ou uma palavra-chave no código e pressione F1 para ir direto para o tópico de ajuda) são muito, muito mais fácil de aprender e usar.

Answer 3

No momento, não, mas nós não escrever um monte de aplicativos do Windows. A maioria são baseados na web. A maioria dos nossos aplicativos do Windows são relativamente pequeno e bem documentado fora de um arquivo de Ajuda.

Além disso, temos as extremidades usuários escrever a documentação durante o processo de desenvolvimento, de modo a documentação é algo que eles vão entender.

No entanto, se eu estivesse escrevendo um app grande para um grande número de usuários (não um aplicativo interno) eu incluiria um arquivo de ajuda sensível ao contexto. Eu tenho feito isso no passado para alguns de nossos aplicativos maiores, e em uma situação não-interna, é muito útil.

Na verdade, agora estamos projetando nosso web site para ter um recurso de "necessidade de ajuda" que é sensível ao contexto, eo recurso foi bem recebido. Estamos incorporá-lo em todo o nosso desenvolvimento web agora, quer para a nossa empresa web site ou interno.

Answer 4

Não existe ajuda? Isso é bom para as pessoas que são tecnicamente inclinados e gostam de brincar com o novo software. Mas se o seu software vai ser usado por pessoas que não são tech savvy, a ajuda é essencial. Leve o seu exemplo de datas. Se você tem um mercado internacional, é melhor esclarecer o que as necessidades do programa. Os americanos usam um formato MM / DD / AAAA, mas a maioria dos usuários internacionais usam DD / MM / AAAA; você precisa explicitar o que o programa precisa.

Eu trabalhei com um monte de desenvolvedores que não tinha absolutamente nenhuma pista sobre seus usuários finais e como eles funcionam. Por exemplo, um CTO que insistiu sua nova empresa deve acabar com a documentação impressa sem saber que seus clientes impressos todos os PDFs ea maioria dos tópicos de ajuda cada vez que havia uma atualização. Você tem que saber o seu usuário final e seu mercado. Infelizmente, muitos desenvolvedores de viver em uma bolha, rodeado por outros desenvolvedores.

Os desenvolvedores devem escrever ajuda? Provavelmente não. A menos que você pode realmente pensar como seus típico usuário final, os projectos de notas, mas deixe um escritor de tecnologia quebrar informações técnicas para o nível das necessidades do usuário final.

Answer 5

Em uma aplicação recente, nós não fornecer ajuda sensível ao contexto. Isto teve razões técnicas, em vez de qualquer outra coisa (o arquivo de ajuda é, essencialmente, um arquivo docbook multi-linguagem, que em suportes teoria ajuda sensível ao contexto, mas não funcionou bem). Tem uma página para cada janela / diálogo na aplicação, com todos os controles explicou. No entanto, cada controle também tem uma dica bastante abrangente, que remove principalmente a necessidade de ajuda adicional. Cada diálogo tem um botão de ajuda para abrir a página específica do diálogo. Historicamente, você pode armazenar o texto dica de ferramenta no arquivo de ajuda, mas isso não parece trabalhar com sistemas de ajuda recentes. E eles estão armazenados em recursos de qualquer maneira.

Mas então, não é uma aplicação para todos. Desde que o sistema de rede que podem ser gerenciados com o aplicativo é um tema complexo em si mesmo, há um treinamento especial para os usuários de qualquer maneira, e o aplicativo foi projetado de modo que se você conhecer o sistema de rede, você também sabe da aplicação. Em outras palavras, não são necessárias as linhas do modelo de aplicação para cima com o modelo de usuário tão bem que recursos abrangentes de ajuda. Este deve ser o objetivo de qualquer desenvolvimento de aplicações.

A maioria das informações nos arquivos de ajuda sobre os controles não é realmente mais do que o que já está na dica, porque ninguém precisa mais.

Office e Visual Studio resolveu o problema bastante semelhante -. Pressionando ajuda abre a página de ajuda para todo o diálogo, não para o único controle

Se você tem uma parte de um diálogo que é tão complicado que precisa de explicação adicional (e dado que você não pode redesenhá-lo para torná-lo mais fácil), você pode colocar a explicação ao lado do controle. Isto é usado em muitas aplicações para casos especiais, de modo que o fluxo de trabalho não é interrompido porque o usuário tem de olhar para cima, por exemplo como um texto específico tem de ser escrito.

Answer 6

Eu nunca ter fornecido ajuda sensível ao contexto em um aplicativo, nem vi isso implementado bem o suficiente em qualquer outra aplicação para nunca usá-lo mesmo. Na minha opinião, o esforço necessário para fazê-lo bem supera o benefício.

Na última aplicação Eu estava envolvido em onde esta decisão tinha de ser feita, usamos balões dica na aplicação, que exibiu um balão de texto quando o usuário pairava sobre cada controle. Também fornecemos um manual convencional, que foi principalmente walkthroughs com lotes de screenshots passo-a-passo.

Depois de algum tempo os usuários ficou doente dos balões e transformou-os fora com uma caixa de seleção que nós fornecemos, mas fez parecem para ajudar os iniciantes a começar.

Answer 7

Todas as aplicações têm ajuda sensível ao contexto na forma de dicas de ferramentas (similares às pontas do Office 2007) para todas as características críticas do aplicativo.

Apesar de não oferecer o, arquivo de ajuda full-blown tradicional, definitivamente temos uma Base de Conhecimento que são atualizadas regularmente. Esta é uma coleção de toda a ajuda prestado aos clientes via telefone, email, etc, em todas e quaisquer questões, devidamente categorizadas e facilmente pesquisáveis. Isto eventualmente acaba por ser a melhor ajuda que contém mais ou menos o que os clientes procuram e não o que que , inicialmente, acho que eles podem precisar.

Enquanto alguns clientes acabam invariavelmente nos contactar, sem tanto como um olhar sobre a base de conhecimento, ainda nos ajuda a partir de reinventar o tempo roda e novamente.

Answer 8

Eu te dou uma opinião pessoal, não é suportado por qualquer outro fato que o meu gosto pessoal.

Escrevendo arquivos de ajuda foi útil no passado, onde tudo foi novos e online recursos eram escassos. Hoje, a maioria dos usuários de computador aprender pela exploração direta. A ajuda contextual na forma de dicas de ferramentas é grande e fortemente encorajados:. dá dicas para este aprendizado exploratório

E sobre documentação de ajuda com um monte de links para clicar ao redor? bem, é aparentemente grande, mas usado muito raramente eu acho. Na maioria dos casos, o usuário pode obter respostas com uma boa pesquisa google. Além disso, este tipo de documentação é caro . Ele não pode ser escrito por um desenvolvedor. Você tem que contratar ou alocar pessoas específicas para isso, com a escrita técnica e clareza como as competências relevantes.

Se eu tivesse que gerenciar essa decisão, eu iria fornecer documentos completos apenas para os recursos que são muito esotérica e especial (eu diria único) para a sua aplicação. Eu iria em qualquer caso, tendem para um tutorial online, em vez de arquivos de ajuda contextuais. Isto tem a vantagem adicional de fornecer informações sobre o quão difícil é usar o aplicativo, e quais são os hotspots mais solicitados (por avaliar os sucessos e consultas de pesquisa do referenciador para seus documentos on-line).

Answer 9

Com dicas de ferramentas e uma geralmente maior capacidade computador usuários, alguns aplicativos fazer muito bem sem arquivos de ajuda. No entanto, alguns aplicativos precisam de arquivos de ajuda, tanto para informação geral tópico como para uso do aplicativo. Por exemplo, em um aplicativo de foto que você pode querer explicar compressão JPEG e incluem algumas amostras no arquivo de ajuda, mesmo que a operação do usuário é auto-evidente.

Parece-me que a Microsoft é um contribuinte para o declínio da ajuda sensível ao contexto, para melhor ou para pior. Primeiro, os sistemas de ajuda no Visual Studio são, para dizer o mínimo, uma dor de usar. Em segundo lugar, a facilidade de uso do sistema de ajuda do Visual Studio foi ladeira abaixo significativamente. Eu vou omitir o discurso retórico, mas basta dizer que é preciso muitos mais cliques e pergaminhos para obter informações relevantes na ajuda VS2008. Isso tende a estabelecer um padrão mais baixo para os sistemas de ajuda em aplicações.