Quel est le problème avec helpfiles ces jours-ci?

Question

J'ai ajouté cette question lors de l'utilisation de SuperUser pour la perspective de l'utilisateur.

Je crée donc une application sous Delphi ou .NET qui s'exécutera sur un système de bureau. Une belle interface graphique avec toutes sortes de fonctionnalités et de fonctionnalités intéressantes. Cela fonctionne bien, les tests me disent que c'est presque sans bug et que je suis sur le point de le déployer ...

WAIT! Un fichier d’aide est nécessaire pour que les utilisateurs puissent faire appel à l’aide contextuelle de l’application!

Ou pas? Les helpfiles sont-ils vraiment indispensables aux applications de bureau de nos jours? Et doivent-ils vraiment être sensibles au contexte, en tenant les mains de l'utilisateur pour lui dire qu'il doit renseigner son jour de naissance dans ce champ intitulé "Jour de naissance"? Ou les fichiers d'aide deviennent-ils un peu démodés?

C’est une question qui me préoccupe et qui est un peu subjective. C’est pourquoi je vais poser une question différente à tous ceux qui développent des applications de bureau: Proposez-vous (toujours) des fichiers d’aide contextuels?

Oui ou non, s'il vous plaît. N'hésitez pas à ajouter des textes subjectifs, mais pour moi, l'important est de savoir si les développeurs modernes continuent d'ajouter une aide contextuelle à leurs applications d'interface graphique.

(D'ailleurs, j'ai moi-même adopté des fichiers PDF non contextuels pouvant être imprimés manuellement. C'est beaucoup plus facile à gérer.)

Answer 1

Oui, je le fais.

Raison: Je ne peux pas m'attendre à ce que l'utilisateur sache comment fonctionne le programme. Ok, décrivant ce qui doit être entré dans un "Jour de naissance" domaine est un peu extrême, mais il y a normalement des choses plus complexes dans un système logiciel. Je devais écrire aujourd'hui un fichier d'aide pour notre système de comptabilité analytique, décrivant le fonctionnement du système de détermination du prix devant être utilisé pour le calcul. Je ne pense pas que les utilisateurs sachent comment configurer le système sans ce fichier d’aide.

Answer 2

Parler en tant qu'utilisateur, pas en tant que développeur - oui, je veux un fichier d'aide sensible au contexte.

Par exemple, je suis en train d'évaluer des contrôles tiers en vue de leur inclusion dans un nouveau projet. Les commandes qui ont une bonne aide contextuelle (vous pouvez par exemple sélectionner une propriété dans la fenêtre des propriétés ou un mot clé dans le code et appuyer sur F1 pour accéder directement à la rubrique d'aide) sont beaucoup plus faciles à apprendre et à utiliser.

Answer 3

Nous ne le faisons pas actuellement, mais nous n'écrivons pas beaucoup d'applications Windows. La plupart sont basés sur le Web. La plupart de nos applications Windows sont relativement petites et bien documentées en dehors d'un fichier d'aide.

De plus, les utilisateurs finaux écrivent la documentation au cours du processus de développement. La documentation est donc quelque chose qu'ils comprendront.

Toutefois, si j'écrivais une application volumineuse pour un grand nombre d'utilisateurs (et non une application interne), j'inclurais un fichier d'aide contextuel. Je l'ai déjà fait par le passé pour certaines de nos plus grosses applications, et dans une situation non interne, c'est très utile.

En fait, nous sommes en train de concevoir notre site Web de manière à avoir un "besoin d'aide". fonctionnalité qui est sensible au contexte, et la fonctionnalité a été bien reçue. Nous l'intégrons maintenant à tous nos développements Web, que ce soit pour le site Web de notre société ou en interne.

Answer 4

Aucune aide? C’est parfait pour les personnes qui ont une tendance technique et aiment jouer avec les nouveaux logiciels. Mais si votre logiciel doit être utilisé par des personnes qui ne sont pas férus de technologie, l'aide est essentielle. Prenez votre exemple de dates. Si vous avez un marché international, vous feriez mieux de définir les besoins du programme. Les Américains utilisent le format MM / JJ / AAAA, mais la plupart des utilisateurs internationaux utilisent JJ ??/ MM / AAAA; vous devez préciser ce dont le programme a besoin.

J'ai travaillé avec de nombreux développeurs qui n'avaient aucune idée de leurs utilisateurs finaux et de leur fonctionnement. Par exemple, un CTO qui a insisté sur le fait que sa nouvelle société devrait se débarrasser de la documentation imprimable sans savoir que ses clients imprimaient tous les fichiers PDF et la plupart des rubriques d'aide chaque fois qu'une mise à jour était disponible. Vous devez connaître votre utilisateur final et votre marché. Malheureusement, trop de développeurs vivent dans une bulle, entourés d'autres développeurs.

Les développeurs doivent-ils écrire de l'aide? Probablement pas. À moins que vous ne pensiez vraiment comme votre utilisateur final typique, rédigez des notes, mais laissez un rédacteur technique casser les informations techniques au niveau dont l'utilisateur final a besoin.

Answer 5

Dans une application récente, nous n'avons pas fourni d'aide contextuelle. Cela tenait à des raisons techniques plutôt qu’autre chose (le fichier d’aide est essentiellement un fichier docbook multilingue qui, en théorie, prend en charge l’aide contextuelle, mais cela n’a pas fonctionné correctement). Il comporte une page pour chaque fenêtre / boîte de dialogue de l'application, avec toutes les commandes expliquées. Cependant, chaque contrôle dispose également d'une info-bulle assez complète, qui élimine généralement le besoin d'une aide supplémentaire. Chaque boîte de dialogue comporte un bouton d’aide pour afficher la page spécifique à cette boîte de dialogue. Historiquement, vous pouviez stocker le texte de l'infobulle dans le fichier d'aide, mais cela ne semble pas fonctionner avec les systèmes d'aide récents. Et ils sont quand même stockés dans les ressources.

Mais alors, ce n'est pas une application pour tout le monde. Le système de réseau pouvant être géré avec l'application étant un sujet complexe en soi, il existe tout de même une formation spéciale pour les utilisateurs. L'application a été conçue pour que, si vous connaissez le système de réseau, vous connaissiez également l'application. En d'autres termes, le modèle d'application s'aligne si bien sur le modèle utilisateur que des fonctionnalités d'aide complètes ne sont pas nécessaires. Cela devrait être l’objectif de tout développement d’applications.

La plupart des informations sur les contrôles contenues dans les fichiers d'aide ne sont pas vraiment plus nombreuses que celles figurant déjà dans l'info-bulle, car personne n'a besoin de plus.

Office et Visual Studio ont résolu le problème à peu près de la même manière: le fait d'appuyer sur l'aide ouvre la page d'aide pour toute la boîte de dialogue, pas pour le contrôle unique.

Si une partie du dialogue est si compliquée qu'elle nécessite une explication supplémentaire (et si vous ne pouvez pas la redéfinir pour la simplifier), vous pouvez placer l'explication juste à côté du contrôle. Ceci est utilisé dans de nombreuses applications pour des cas particuliers, de sorte que le flux de travail ne soit pas interrompu car l'utilisateur doit rechercher, par exemple, comment un texte spécifique doit être écrit.

Answer 6

Je n'ai jamais fourni d'aide contextuelle dans une application, ni l'ai vue suffisamment bien implémentée dans une autre application pour pouvoir l'utiliser moi-même. À mon avis, les efforts requis pour le faire sont bien supérieurs aux avantages.

Lors de la dernière application dans laquelle je devais prendre cette décision, nous avons utilisé des info-bulles dans l'application, qui affichaient une info-bulle lorsque l'utilisateur survolait chaque contrôle. Nous avons également fourni un manuel conventionnel qui consistait principalement en des procédures pas à pas avec de nombreuses captures d’écran pas à pas.

Après un certain temps, les utilisateurs en ont eu marre des ballons et les ont désactivés avec une case à cocher que nous avons fournie, mais cela semblait aider les débutants à démarrer.

Answer 7

Toutes nos applications disposent d'une aide contextuelle sous forme d'infobulles (semblables aux astuces d'Office 2007) pour toutes les fonctionnalités critiques de l'application.

Bien que nous n'offrions pas le fichier d'aide traditionnel complet, nous disposons d'une base de connaissances que nous mettons à jour régulièrement. Ceci est une collection de toute l'aide fournie aux clients par téléphone, courrier électronique, etc., sur toutes les questions, correctement classée et facilement interrogeable. Cela finit par être la meilleure aide, qui contient plus ou moins ce que les clients recherchent plutôt que ce que nous pensons au départ qu’ils pourraient avoir besoin.

Même si quelques clients finissent toujours par nous contacter sans un coup d'œil à la base de connaissances, cela nous aide néanmoins à réinventer la roue encore et encore.

Answer 8

Je vous donne un avis personnel, qui ne repose sur aucun autre fait que mon goût personnel.

Écrire des fichiers d’aide était utile dans le passé, où tout était nouveau et où les ressources en ligne étaient rares. Aujourd'hui, la plupart des utilisateurs d'ordinateurs apprennent par exploration directe. L’aide contextuelle sous forme d’infos est très utile et vivement encouragée: elle donne des pistes pour cet apprentissage exploratoire.

Qu'en est-il de la documentation d'aide avec beaucoup de liens sur lesquels cliquer? eh bien c'est apparemment génial, mais utilisé très rarement je suppose. Dans la plupart des cas, l'utilisateur peut obtenir des réponses avec une recherche Google appropriée. De plus, ce type de documentation est coûteux . Il ne peut pas être écrit par un développeur. Vous devez embaucher ou affecter des personnes spécifiques à cet effet, avec une rédaction technique et des compétences claires comme compétences pertinentes.

Si je devais gérer cette décision, je fournirais une documentation complète uniquement pour les fonctionnalités très ésotériques et spéciales (je dirais uniques) pour votre application. J'aurais de toute façon tendance à utiliser un tutoriel en ligne plutôt que des fichiers d'aide contextuels. Cela présente l’avantage supplémentaire de fournir des informations sur la difficulté d’utiliser votre application et sur les points chauds les plus demandés (en évaluant les hits et les requêtes de recherche des sites référents sur vos documents en ligne).

Answer 9

Avec les info-bulles et les capacités informatiques généralement accrues des utilisateurs, certaines applications fonctionnent parfaitement sans fichiers d’aide. Cependant, certaines applications nécessitent des fichiers d’aide, tant pour les informations générales que pour leur utilisation. Par exemple, dans une application photo, vous voudrez peut-être expliquer la compression jpeg et inclure des exemples dans le fichier d'aide, même si l'opération de l'utilisateur est évidente.

Il me semble que Microsoft contribue au déclin de l'aide contextuelle, pour le meilleur ou pour le pire. Premièrement, les systèmes d’aide de Visual Studio sont pour le moins difficiles à utiliser. Deuxièmement, la facilité d'utilisation du système d'aide de Visual Studio s'est considérablement dégradée. Je vais omettre le discours, mais il suffit de dire qu'il faut beaucoup de clics et de défilement supplémentaires pour obtenir des informations pertinentes dans l'aide de VS2008. Cela tend à imposer une norme inférieure aux systèmes d’aide dans les applications.