tag:blogger.com,1999:blog-80228358294711573502024-02-21T14:03:33.378+01:00Histoire d'écrire de l'informatiqueQuelques réflexions à partager sur l'écriture informatique, livres et tutorielsChristophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.comBlogger21125tag:blogger.com,1999:blog-8022835829471157350.post-87041597528387207842010-03-25T10:38:00.005+01:002010-03-25T10:57:35.345+01:00Les césures<img style="float: left; margin: 0pt 10px 10px 0pt; cursor: pointer; width: 200px; height: 126px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhzZfUbxks7Sy_at75C1Hwht2r0Xj_CYLZVA-lvzCDfYqNVyCS-a6-o9Eewhjki5wid5NyNC48XmyleXZIfN-ffjjPi2ZffaK9u8649tnFea6JjCWRSlNaaeVruUoNrwuNv9omXPHHhlkc/s400/hache.jpg" alt="" id="BLOGGER_PHOTO_ID_5452507793339240770" border="0" />Les césures sont un véritable "problème" dans la rédaction d'un ouvrage et dans la mise en page de celui-ci.<br /><br />La première interrogation porte sur la présence d'une césure dans le libellé d'un mot d'interface : menu, item de menu, boite de dialogue, champ de saisie, case à cocher.... Supposons que le rédacteur parle à un libellé d'interface nommé <span style="font-weight: bold;">Présentation</span>. Le hasard de la mise en page introduit une césure dans ce mot : <span style="font-weight: bold;">Présen-tation</span> par exemple. Comment va réagir le lecteur ? Sera-t-il troublé par cette césure ? Cela va-t-il le déconcerter ? Va-t-il avoir du mal a repérer ce libellé dans l'interface ? Ou au contraire cela ne va en aucune manière le gêner ? Pour ma part je préfère qu'il n'y ait pas de césure dans tous les libellés d'interface.<br /><br />Le deuxième cas le plus embêtant est la présence de césure dans du code informatique. Je prends l'exemple d'une propriété CSS <span style="font-family:courier new;">background-color</span>. La présence d'un tiret est normale et impérative dans la syntaxe de cette propriété. Donc si une autre césure apparaît, cela introduit une erreur de syntaxe : <span style="font-family:courier new;">back-ground-color</span> ne veut strictement rien dire. C'est clairement une erreur de syntaxe. Donc il faut impérativement faire la "chasse" à ces césures lors de la relecture du livre mis en page.<br /><br />Vous retrouverez le même principe avec les URL. Dans les adresses web, nous avons la présence normale de tiret. Donc en ajouter d'autres introduit des adresses erronées.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-88781556015970315292009-10-21T11:40:00.001+02:002009-10-21T11:45:35.663+02:00Le public ciblé et les prérequis des livres techniques<h4>Quand nous achetons un livre technique, nous aimerions ne pas nous tromper sur le public visé et sur les prérequis nécessaires à la bonne compréhension du livre.</h4><img style="margin: 0pt 10px 10px 0pt; float: left; width: 106px; height: 160px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjbfA1FLWuz3WzuGymnn1hFjfq8jhWVIoiGcYQi23_oRA8t7O9iFjEDhGqDpBG6W4hBfsB15weoZf3nYdZ44Diopookd8oN6Y-OKgYz7WptY7yOGemnp9ziA-nIUayIYk2nWYcV5BbjG9U/s400/new-008.png" alt="" id="BLOGGER_PHOTO_ID_5394986848013140962" border="0" />Il me paraît indispensable que les éditeurs de livres techniques, à travers leurs très nombreuses collections, indiquent systématiquement quel est le <span style="font-weight: bold;">public visé</span>. En fonction du niveau de compétence de chacun, nous voulons que le livre soit bien ciblé à nos besoins. Une personne très qualifiée ne sera pas intéressée par un livre expliquant les bases d'un logiciel et un débutant sera perdu par des précisions techniques très pointues pour des personnes ayant dix ans d'expertise. Si dès la quatrième de couverture, l'éditeur précise le public visé, c'est un plus indéniable et appréciable. Bien sûr vous allez me répondre que le libellé peut parfois prêter à confusion : qu'est-ce qu'un expert ? Qu'est-ce qu'une personne confirmée ? Qu'est-ce précisément une personne maîtrisant telle ou telle technologie ? Certes, mais en ayant l'indication du public visé et en parcourant rapidement les pages du livre, nous pouvons nous faire très rapidement une opinion : ce livre est-il fait ou non pour moi, selon mes compétences.<br /><br />De la même manière, connaître <span style="font-weight: bold;">les prérequis</span> est aussi une information indispensable à connaître avant d'acheter un livre technique. Supposons que j'achète un livre sur Photoshop pour faire de la retouche de photos. Dois-je avant cela être capable de maîtriser la prise de vue ? Va-t-on aborder dans ce livre la notion de balance des blancs ? La notion de sensibilité ISO des vues ? Dois-je déjà connaître les bases de Photoshop et de son interface ? Supposons que je veuille acheter un livre sur le design web avec les CSS (Cascading Style Sheets), dois-je connaître le HTML ? Dois-je avoir déjà créé un site web ? Là encore, avoir ces informations en quatrième de couverture est indispensable pour le choix d'un livre technique.<br /><br />A tous les éditeurs de livres techniques : s'il vous plait, indiquez ces informations pour guider au mieux vos lecteurs, vos acheteurs.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com1tag:blogger.com,1999:blog-8022835829471157350.post-25063254583623280662009-10-06T22:29:00.008+02:002009-10-06T22:54:34.715+02:00Livre Bien rédiger pour le web - Points d'améliorationTout d'abord merci à Isabelle de son commentaire constructif. Je ne réponds que maintenant, avec du retard (je suis en phase finale de rédaction d'un livre...). Voilà quelques remarques concernant le code HTML/CSS :<br /><br /><h4>Les noms des éléments HTML :</h4>L'auteur parle systématiquement de balises au lieu d'éléments HTML. Rappelons qu'un élément HTML est composé d'une balise d'ouverture, d'un contenu et d'une balise de fermeture.<br />Le libellé des éléments HTML et des attributs est écrit avec des majuscules. C'est une syntaxe obsolète : privilégions uniquement des minuscules.<br /><br /><h4>Confusion sur l'attribut alt, page 99.</h4>Le texte qui apparaît au survol d'une image (ou d'un autre élément HTML) est l'attribut title et non l'attribut alt. L'attribut alt est une alternative textuelle à l'image. La valeur de l'attribut alt apparaît quand l'image n'est pas encore chargée, ou bien quand l'image n'est pas chargée. Ce texte peut aussi apparaître si l'internaute a demandé à ne pas afficher les images (pour gagner du temps au chargement). C'est bien la valeur de l'attribut title qui est affiché au survol de la souris. Cette confusion provient souvent d'une mauvaise interprétation de Microsoft Internet Explorer.<br /><br /><h4>Accessibilité et typographie, page 111</h4>La police de caractère Arial, comme le Tahoma ne sont pas des polices faites pour la lecture à l'écran. Ce sont des polices qui ont été créées pour l'impression. Il est préférable de recommander la police Verdaana qui a été créée par le typographe américain Matthew Carter, pour une bonne lisibilité à l'écran.<br />Pour mettre en gras,simple mise en forme visuelle, nous pouvons utiliser l'élément HTML ‹b›. Mais pour une synthèse vocale, il n'y a pas de différence. C'est pour cela qu'il faut utiliser l'emphase forte : ‹strong› qui permet une différence vocale du synthétiseur. Il en est de même avec l'italique ‹i› et l'emphase ‹em›.<br />Plus gênant, le paragraphe sur la taille des caractères. Si le concepteur utilise une taille de caractère fixe : en point (comme c'est indiqué dans le livre, page 112) ou en mm, cm... la personne handicapée ne pourra pas agrandir le texte proportionnellement. Il faut impérativement utiliser des unités relatives : le pourcentage (%) ou le cadratin (em). Sachez que par défaut les navigateurs utilisent valeur relative 1 em (ou 100%) = 16 points.<br />L'auteur revient sur ce sujet page 174 en indiquant bien l'utilisation préférable de la police Verdana. Page 175, l'auteur indique bien d'utiliser des tailles relatives.<br /><br /><h4>Abréviations et Acronymes, page 139</h4>Précisons que deux éléments HTML sont prévus pour gérer les abréviations et les acronymes : ‹abbr› et ‹acronym›.<br /><br /><h4>Les ancres - Page 151</h4>Attention, la valeur de l'attribut name de l'élément a, doit respecter des règles d'écriture. Il doit contenir des lettres, des chiffres, des tirets et des tirets bas (underscore). Mais pas d'espace, ni de caractères accentués, ni l'apostrophe, comme le montre l'exemple. Il eut été plus judicieux de mettre un exemple de type : ‹a name="titre"›‹/a›.<br /><br /><h4>Mise en forme du texte, page 180, 181 et 184</h4>L'élément HTML pour mettre en exposant est effectivement ‹sup›. J'ajoute que l'élément HTML pour mettre en indice est ‹sub›. Pour les chimistes cela est indispensable.<br />Pour les abréviations et les acronymes, je réitère mas remarques précédentes (pour la page 139).<br />Pour les petites capitales, l'auteur montre un exemple avec une syntaxe totalement obsolète aujourd'hui : l'utilisation de l'élément ‹span›. Utilisez les feuilles de styles.<br />Enfin, pour écrire en petites capitales, l'auteur indique une syntaxe CSS de type "en ligne". C’est-à-dire que le code CSS est inséré directement dans l'élément HTML. Pas pratique du tout car l'auteur ne peut pas réutiliser cette mise en forme. Il faut créer un sélecteur de classe pour créer la règle et l'appliquer rapidement autant de fois qu'il est nécessaire.<br /><br />Voilà, rapidement, quelques remarques constructives. Si je vois d'autres éléments importants, je vous en ferai part.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com2tag:blogger.com,1999:blog-8022835829471157350.post-1845197412812888592009-09-21T07:51:00.002+02:002009-09-21T07:54:22.925+02:00Livre Bien rédiger pour le webSynthèse de lecture sur <span style="font-weight: bold;">Bien rédiger pour le web... et améliorer son référencement naturel</span><br />Je suis en train de terminer la lecture de l'ouvrage d'<span style="font-weight: bold;">Isabelle Canivet</span>. Mon avis reste sur une impression mitigée.<br />L'ouvrage se lit très bien, le style est clair et les exemples très parlants. Pas de problème.<br />Là où je suis un peu déçu, c'est sur l'épaisseur du livre : il y a parfois (souvent ?) des redites, même à quelques pages d'intervalles. L'ouvrage aura largement gagné à être plus synthétique, plus court. Nous aurions eu alors une lecture plus dynamique en allant directement à l'essentiel (conseil pourtant répété 45 fois dans le livre).<br />Deuxième petit souci, des approximations dès lors que l'auteur parle technique et code HTML / CSS. Clairement ce n'est pas son domaine de prédilection.<br />Mais cela reste un livre largement recommandable. A lire donc.<br />PS : me reste la partie référencement à lire, pour un autre billet.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com2tag:blogger.com,1999:blog-8022835829471157350.post-35368313131561255622009-07-12T10:02:00.005+02:002009-07-12T10:10:37.269+02:00Une lecture et des vacances...<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg2lpaZNHGFs0ARfu3LdXnmreaO3erhMHQIe_x_vVqNTsTRPsKfyDAigJJ6aH6NJ10kvkp1_b8YKa3wfMONd9vEdaswtBpBYGGQLM3AzW6NTOTGrWnwQHnd1SUMTp4ijyDM5Af6xQWOm3E/s1600-h/rediger-web.png"><img style="margin: 0pt 10px 0pt 0pt; float: left; width: 127px; height: 150px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg2lpaZNHGFs0ARfu3LdXnmreaO3erhMHQIe_x_vVqNTsTRPsKfyDAigJJ6aH6NJ10kvkp1_b8YKa3wfMONd9vEdaswtBpBYGGQLM3AzW6NTOTGrWnwQHnd1SUMTp4ijyDM5Af6xQWOm3E/s400/rediger-web.png" alt="écrire,informatique, livre, rédiger" title="écrire,informatique, livre, rédiger" id="BLOGGER_PHOTO_ID_5357482066251049826" border="0" /></a>Voici une de mes lectures pour cet été : <span style="font-weight: bold;">Bien rédiger pour le web ...et améliorer son référencement naturel</span> d'<span style="font-weight: bold;">Isabelle Canivet</span>, paru aux Editions Eyrolles. Le site web étant déjà très bien fait (<a href="http://www.action-redaction.com/" target="_black">www.action-redaction.com</a>), je pense que nous avons là une lecture prometteuse.<br /><br /><br /><br />Et ce blog va prendre aussi des vacances, je vous retrouve à la rentrée.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-68030861445549192212009-06-29T07:37:00.004+02:002009-06-29T07:42:16.601+02:00Interview de Corinne Hervo, responsable de collection aux Editions ENI - 2e partie<a href="http://www.editions-eni.com/"><img style="margin: 0pt 10px 10px 0pt; float: left; width: 52px; height: 52px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgXtTmND7kawLxC9hTQ95TLuwP9Aaan4E6ANLJdvngcZYAtK2QUevfUM7AkQ3e-AEXkZVI1xiaGfsHUE94a9SEqVuWnDSC-MwltXZrk6Kr1PFpj76wkdqNnb2Jp3QzvhBtk6CdFjqTtn1M/s400/editions-eni.png" alt="Editions ENI, informatique, livre, écrire" title="Editions ENI, informatique, livre, écrire" id="BLOGGER_PHOTO_ID_5352619933525816146" border="0"></a><font style="font-weight: bold;">Avez-vous un travail de relecture aussi important pour le rédactionnel que pour l'aspect technique des livres ?</font><br />La relecture technique est fondamentale : tous les relecteurs sont des professionnels de l’informatique (en majorité formateurs ou auteurs) et sont en mesure d’effectuer une relecture critique tant d’un point de vue compréhension technique que pédagogique (savoir analyser la structure du livre pour en comprendre le fondement pédagogique, par ex).<br /><br /><font style="font-weight: bold;">Est-ce la même personne qui s'occupe de la relecture technique et de la relecture rédactionnelle ?</font><br />En règle générale, oui, sauf pour certains livres très techniques pour lesquels la double compétence est plus difficile à trouver.<br /><br /><font style="font-weight: bold;">Donnez-vous des conseils rédactionnels aux auteurs ?</font><br />Oui, notre rôle est de suivre et de soutenir l’auteur (surtout s’il est novice) : nous recherchons avant tout la compétence professionnelle et nous mettons notre expérience d’éditeur à la disposition de l’auteur pour l’aider dans cette merveilleuse aventure que peut être l’écriture d’un livre ; c’est un travail d’équipe et cela rassure beaucoup certains de nos nouveaux auteurs.<br /><br /><font style="font-weight: bold;">Les auteurs acceptent-ils facilement les corrections proposées ?</font><br />Oui, en règle générale, ils apprécient beaucoup ce regard critique sur leur livre qui leur permet encore de l’améliorer ; c’est aussi le rôle du Responsable de collection de régler les (légères) dissensions qui peuvent survenir parfois entre auteur et relecteur.<br /><br /><br /><span style="font-style: italic;">Merci d'avoir répondu à mes questions.</span>Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-60277718595251960582009-06-22T12:40:00.007+02:002009-06-22T12:49:45.942+02:00Interview de Corinne Hervo, responsable de collection aux Editions ENI<a href="http://www.editions-eni.fr/" target="_blank" ><img style="margin: 0pt 10px 10px 0pt; float: left; width: 52px; height: 52px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjXH4egzAPlRRhZI0KYJNBA0U6x5UaBMkJKcwxNlMdGYcjvHqs9TY7Z06bM-mu_dtV3GSJM20VgJs2vdp9fwuo301lARjjqabFUfZWbQ98d-hZInMkdrg_iDkzbxADYSZDnQ27ZhgOxmAs/s400/editions-eni.png" alt="livre, écrire,informatique,Editions ENI" title="livre, écrire,informatique,Editions ENI" id="BLOGGER_PHOTO_ID_5350100720340902418" border="0"/></a><br />Voici la première partie d'une interview de <span style="font-weight: bold;">Corinne Hervo</span>, responsable de collection aux <a href="http://www.editions-eni.fr" target="_blank">Editions ENI</a>.<br /><br /><br /><br /><span style="font-weight: bold;">Comment s'organise la notion de collection aux Editions ENI ?</span><br />Plusieurs critères entrent en ligne de compte mais globalement, on peut simplifier en disant que chaque collection correspond à un public visé ; ce public peut être défini par son niveau en informatique (débutant, utilisateur, informaticien, expert…), par un centre d’intérêt (graphisme, bureautique, certifications…) ou par la méthode d’apprentissage recherchée (aide-mémoire, autoformation pas à pas, TP…). Ces 3 orientations se cumulent les unes aux autres et expliquent que nous proposons aujourd’hui plus de 20 collections, un même sujet étant décliné dans plusieurs collections : par ex, la sortie de Windows Seven peut générer jusqu’à une dizaine de livres : pour le débutant, pour l’utilisateur bureautique qui veut découvrir les fonctionnalités de façon détaillée ou au contraire condensée, pour celui qui veut apprendre par la pratique, pour l’informaticien qui devra installer les postes Seven, pour l’expert et pour celui qui est intéressé par la Certification Microsoft.<br /><br /><span style="font-weight: bold;">Quel est votre rôle en tant que responsable de collection ?</span><br />Le Responsable de collection définit la ligne éditoriale de la collection (comment la connaissance est-elle diffusée, à quel niveau) ce qui se traduit par des règles précises au niveau de la rédaction (choix des termes) et de la mise en page (utilisation de titre et sous-titres à l’infinitif, par ex, découpage de chaque manipulation par étape…) ; son rôle consiste à expliquer cette ligne éditoriale aux auteurs et à s’assurer qu’elle est respectée.<br /><br /><span style="font-weight: bold;">Est-ce que chaque collection possède son propre type d'écriture ?</span><br />Oui, c’est ce qu’on appelle « le moule », le style d’écriture est lié aussi aux principaux formats de paragraphes et donc à la mise en page. De nombreuses similitudes existent cependant entre les livres de même type (livre de référence, par ex) appartenant à des collections différentes.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-77420442891135482652009-06-16T21:14:00.003+02:002009-06-16T21:20:40.532+02:00Les différents types d'ouvrages : les références<img style="margin: 0pt 10px 10px 0pt; float: left; width: 160px; height: 106px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjtc86usQjWd502Xj7GwIMkd4XmXrtSdn6FbWVNfx_g03Zjr9bU165jS4DLDWFmfHVLZSBXOPCBRrFEfBQH43hyAzTFJkBrONt9LrfOBjZSDCcwfBWBDabxarPTe4UAR2axGAof1gakigA/s400/new-007.png" alt="expérience, informatique, livre, référence, écrire" id="BLOGGER_PHOTO_ID_5348007207479807266" title="expérience, informatique, livre, référence, écrire" border="0" />Dans les divers ouvrages techniques, informatiques qui nous sont proposés, nous avons à notre disposition plusieurs types de livres.<br /><br />Les <span style="font-weight: bold;">livres de références</span> sont les plus classiques.<br /><br />Ces ouvrages proposent une alternative au manuel "officiel" du logiciel, quand il existe. Ces manuels "officiels" ont parfois deux défauts. Une traduction de l'anglais (ou de l'américain) vers le français qui laisse à désirer : nous avons des phrases mal construites, des mots mal utilisés, des néologismes, des anglicismes...<br /><br />Dans ce cas un livre de référence écrit par un professionnel apporte énormément au lecteur, à l'utilisateur du logiciel : l'écrit est clair, précis et bien rédigé (c'est du moins ce que nous devons pouvoir espérer !).<br /><br />Deuxième défaut, c'est tout simplement l'absence de version papier du manuel d'utilisation. Actuellement la plupart des éditeurs informatiques privilégient les versions électroniques en ligne des manuels d'utilisation des logiciels. L'argument premier est la réactivité de mise à jour du manuel. Ce qui est vrai. Mais avoir un manuel "papier" donne un certain confort à l'utilisateur. Enfin, la traduction peu là aussi laisser à désirer.<br /><br />Enfin, l'auteur peut (doit ?) aussi apporter en plus du manuel "officiel", son <span style="font-weight: bold;">expérience d'utilisateur</span> : qu'est-ce qui d'usage courant, quelles sont les fonctionnalités secondaires, voire obsolètes que l'utilisateur peut ne pas utiliser sans conséquence, comment il a résolu tel ou tel problème avec telle ou telle fonctionnalité du logiciel étudié. L'auteur peut aussi apporter des précisions techniques sur des <span style="font-weight: bold;">concepts</span> plus généraux qui ne sont pas directement liés au logiciel. Par exemple des précisions techniques sur les formats de fichiers utiles dans les médias web ou print, dans l'utilisation de logiciels graphiques de création de sites web ou de mise en page. L'auteur peut aussi apporter des précisions concernant l'<span style="font-weight: bold;">utilisation du logiciel étudié avec d'autres produits</span>, d'autres logiciels de même catégorie. Pourquoi se contenter d'évoquer l'utilisation unique d'un Adobe InDesign, alors que ce logiciel est fait pour travailler avec Adobe Illustrator et Adobe Photoshop.<br /><br />L'<span style="font-weight: bold;">auteur</span> ne doit pas se contenter d'un simple "listing" des fonctionnalités du logiciel : il doit apporter un plus, son <span style="font-weight: bold;">expérience de praticien</span>.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-43019518160781837622009-05-26T08:04:00.002+02:002009-05-26T08:09:50.867+02:00Écrire l'introduction en dernier<img style="margin: 0pt 10px 10px 0pt; float: left; width: 106px; height: 160px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEi2igEGJduc8jz8Uz6a5qAgh1LVdyDTgFwnZ6YZwyd4lAfv__gtoa7M6fak63Ykkaap-zfadK-lJ6_zEIpy-EIM0H87FQIOHrHft5FxzjnlwWtuVOVys5V5AzBruPzbj0OEsfMHFVWhYBA/s400/new-006.png" alt="écrire,livre, informatique, introduction,dernier,fin" title="écrire,livre, informatique, introduction,dernier,fin" id="BLOGGER_PHOTO_ID_5340010475677977842" border="0" />Voilà un fait qui peut vous paraître étonnant ! Mais oui, personnellement j'écris l'introduction toujours à la fin de la rédaction.<br /><br />L'introduction dans un livre joue le même rôle que le chapô en presse : c'est lui qui va donner l'envie de lire le livre, de lire l'article en presse<br />C'est donc quand j'ai terminé de rédiger le livre que j'ai enfin une bonne <span style="font-weight: bold;">vision globale</span> de ce qu'il va apporter au lecteur. Je peux comprendre <span style="font-weight: bold;">dans son ensemble</span> ce que va acquérir le lecteur. À la fin de la rédaction, je sais ce que j'ai écrit, comment je l'ai écrit, ce que va gagner le lecteur en lisant l'ouvrage. À ce moment-là je peux écrire une introduction qui va inciter le lecteur à acheter le livre.<br />Si vous écrivez l'introduction dès le début de la rédaction, vous n'avez pas encore l'orientation rédactionnelle précise du livre, vous n'avez pas encore le "fil rouge". Vous ne savez pas encore comment vous allez amener le lecteur là où vous souhaitez aller.<br /><br />Donc comme en presse pour le chapô, essayez de <span style="font-weight: bold;">rédiger vos introductions en dernier</span>.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-11116557422456395952009-05-09T14:00:00.006+02:002009-05-09T14:14:00.766+02:00Un verbe d'action dans les titres<img style="margin: 0pt 10px 10px 0pt; float: left; cursor: pointer; width: 120px; height: 160px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgevAPLjyJoqDukWAkzbt_2-5TcX-b7lu2ra9Q2aSteVnlJ3CEVHkyHiqeEmWqlonTQTY48FjIE3gGDNpTPVU562wvQnNNwaM5wlio19Ao7K-nJpCKwbHc928CqsKqqMs_D3VPvIPGmV2c/s400/new-005.png" alt="action, informatique, livre, titre, verbe, écrire" id="BLOGGER_PHOTO_ID_5333795836281076594" border="0" />Un chapitre d'un livre est structuré en paragraphes. Chaque paragraphe est annoncé par un titre. Nous allons maintenant évoquer contenu des titres. Nous avons déjà évoqué <a href="http://ecrire-informatique.blogspot.com/2009/03/de-limportance-des-titres.html">l'importance des titres et leurs différents types</a> dans un article précédent.<br /><br />Il me semble très intéressant de placer un <span style="font-weight: bold;">verbe d'action</span> dans les titres. Cela va permettre de donner du <span style="font-weight: bold;">dynamisme</span> au titre. L'objectif étant de donner au lecteur l'envie de lire le paragraphe. Il faut donc éviter une forme passive, voire ennuyeuse. Nous devons indiquer ce qui va se passer dans le texte qui va suivre en plaçant un verbe d'action.<br /><br />Par exemple évitons d'écrire : "<span style="font-style: italic;">Le paramétrage du nouveau document</span>", mais plutôt "<span style="font-style: italic;">Paramétrer le nouveau document</span>".<br />Utiliser un verbe d'action à l'infinitif implique beaucoup plus le lecteur, il se sent forcément concerné, il va devoir <span style="font-weight: bold;">agir</span>, réaliser une action. Personne d'autre que lui va devoir passer à l'action.<br />De plus, commencer tout de suite par le verbe, permet d'entrer immédiatement dans le vif du sujet, <span style="font-weight: bold;">au cœur de l'action</span>, vous interpellez sur-le-champ le lecteur.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com1tag:blogger.com,1999:blog-8022835829471157350.post-24817388067858740322009-04-26T10:45:00.011+02:002009-04-26T11:52:22.157+02:00Faire des phrases simples et courtes<img style="margin: 0pt 10px 10px 0pt; float: left; width: 106px; height: 160px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgALw7_i3l8kOSIBqu7b9npPONEDmKWBPtJ5ZR9GgPCQPLu1xNTLdODZoa8fyOiKGp3he9mqHCPkm_fEbFmO3BRu20bwgqOvzNXMr4XMdMwS6Lv26pnlrvpZvIStyT1nN4yOHYz6lQhpJ8/s400/new-001.png" alt="écrire,livre,informatique, phrase,courte,simple" id="BLOGGER_PHOTO_ID_5328929267694852178" border="0" />L'écriture dans un livre informatique pédagogique doit être réalisée avec des <span style="font-weight: bold;">phrases courtes et simples</span>. Cela rejoint l'écriture pour le web. Plus les phrases sont longues alambiquées, plus l'utilisateur sera gêné et il devra alors relire une fois, deux fois la phrase avant de la comprendre. Tout cela nuit à la compréhension rapide d'un texte.<br /><br />Voilà un exemple d'une phrase un peu trop complexe à mon goût, extraite d'un livre sur l'utilisation du logiciel Adobe Dreamweaver. C'est une explication sur la façon d'annuler l'application d'un style CSS :<br />"<span style="font-style: italic;">Pour annuler l'application d'un style, sélectionnez l'élément qui utilise ce style puis choisissez Format - Styles CSS - Aucun ou dans le menu déroulant Règle cible (ou Classe) du panneau Propriétés, cliquez sur Supprimer la classe ou dans le menu déroulant Classe cliquez sur Aucune</span>".<br />Ouf ! Maintenant vous pouvez respirer !<br /><br />Alors analysons cette phrase.<br /><br />- Cette phrase comporte <span style="font-weight: bold;">46 mots</span> ! C'est beaucoup trop. Pour moi, il faut compter <span style="font-weight: bold;">20-25 mots</span> par phrase.<br /><br />- La phrase contient <span style="font-weight: bold;">trois fois</span> le mot <span style="font-weight: bold;">ou</span>. C'est un <span style="font-weight: bold;">indicateur</span> très précis d'une <span style="font-weight: bold;">phrase trop longue</span>. A partir du moment où vous utilisez plusieurs fois le mot "<span style="font-style: italic;">ou</span>", cela doit être un indicateur pour vous dire "Ma phrase est trop longue. Est-ce que je peux en faire plusieurs à chaque utilisation du mot ou". J'ajoute que l'utilisation du mot "<span style="font-style: italic;">puis</span>", dans ce contexte, donne le même effet que le mot "<span style="font-style: italic;">ou</span>".<br /><br />- Le rédacteur écrit : "<span style="font-style: italic;">Règle cible (ou Classe)</span>". Là c'est une erreur pédagogique. De quoi parle-t-on ? D'une Règle cible ou d'une Classe ? Cela ne peut pas être les deux en même temps. Si c'est l'un ou l'autre, il faut alors en <span style="font-weight: bold;">expliquer le contexte d'utilisation</span> : quand devons-nous utiliser une Règle cible ou une Classe ? A la lecture de cette phrase l'utilisateur est incapable de savoir quand il doit passer par Règle cible ou Classe.<br /><br />- Puis nous lisons ensuite que cela ce passe dans le panneau Propriétés. Il eut fallut le dire avant ! Il faut <span style="font-weight: bold;">toujours situer l'environnement d'utilisation avant</span> de parler d'un élément d'interface de cet environnement (voir l'article <a href="http://ecrire-informatique.blogspot.com/2009/03/le-chemin-dacces-aux-elements.html">Le chemin d'accès aux éléments d'interface</a>).<br /><br />Voilà ce que je propose comme correction :<br />"<span style="font-style: italic;">Pour annuler l'application d'un style, sélectionnez l'élément qui utilise ce style. Dans le panneau Propriétés, avec le bouton CSS actif, dans la liste déroulante Règle cible, choisissez Supprimer la classe. Toujours dans le panneau Propriétés, avec le bouton HTML actif, dans la liste déroulante Classe, choisissez Aucune.</span>"<br />J'ai ainsi trois phrases de 14, 19 et 17 mots.<br />Je n'ai pas utilisé les mots "ou" et "puis".<br />J'ai bien indiqué d'abord l'environnement dans le quel le lecteur va trouver les éléments décrits : le panneau Propriétés et après les éléments d'interface de ce panneau.<br />J'ai bien indiqué le contexte d'utilisation des deux possibilités pour annuler le style : avec le bouton CSS ou avec le bouton HTML actif.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com1tag:blogger.com,1999:blog-8022835829471157350.post-17881532688753095842009-04-14T08:19:00.006+02:002009-04-26T11:48:12.985+02:00Rappel à une fonction, une option<img style="margin: 0pt 10px 10px 0pt; float: left; width: 160px; height: 120px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgdJlbe4ydXgvuDsifPvHf5fEyut84C2n0yQqgS4F2a4Tjxa2MbqdU06s8hxdq396Eex3F1StuohZj8b8fvS3rZmKSuGb1AcoVjhemy-SQ6zBs2Lsz58UEhmTGqZhorJ3nINRxdF5MHioM/s200/new-017.png" title="écrire,informatique" alt="informatique, nom, rappel, écrire,livre, fonctionnalité, option" id="BLOGGER_PHOTO_ID_5324596731586147602" border="0" />Dans une page constituée de plusieurs paragraphes, le rédacteur peut évoquer plusieurs fois une fonction, une commande, une option donnée.<br /><br />A la <span style="font-weight: bold;">première évocation</span> de cette fonction, il faut clairement la décrire et correctement la nommer, avec le <span style="font-weight: bold;">même nom</span> que dans l'application, le logiciel étudié.<br /><br />Quand nous devons de nouveau évoquer cette fonction, il faut impérativement la nommer de la <span style="font-weight: bold;">même façon</span> que la première fois. Il ne faut surtout pas mettre en difficulté le lecteur en changeant son nom.<br /><br />De plus, nous ne devons pas l'évoquer en utilisant un mot "passe-partout" dénué de sens, type : "cette option", "cette fonction" ou "cette commande". Le lecteur ne pourra pas facilement faire le lien entre ces mots "passe-partout" et le nom de la fonction que nous souhaitons évoquer de nouveau.<br /><br /><span style="font-weight: bold;">Il faut toujours faire appel à une fonction en l'évoquant par son nom utilisé dans l'application.</span>Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-12124415889583621732009-04-05T14:12:00.001+02:002009-04-26T11:47:31.686+02:00Même mot pour la même action<span style="font-weight: bold;">A la rédaction d'un livre, il faut bien faire attention à toujours utiliser le même mot pour la même action.</span><br /><br /><img style="margin: 0pt 10px 10px 0pt; float: left; width: 160px; height: 106px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiy_u8cCfg5KGtfBBQQHU6M4eVMNluPtOxayLQkTivkeQSdlcksW-IkLvv3SJrWf740p9ambpnVDaxnDxLs5o_UKWjwKOlq9b8dW0v1gvQAFzUKsI2JQTGPKTj4xI71TySvWpnYL0pq5ws/s400/new-016.png" alt="action, informatique, mot, écrire, livre" id="BLOGGER_PHOTO_ID_5321135899918488834" border="0" />Je vais prendre un exemple bien concret que j'ai déjà vu dans un (des) livre(s) : le mot choisi pour désigner l'action d'utilisation d'un item d'un menu. Dans le même ouvrage, j'ai noté tous ces mots :<br /><ul><li>choisir,</li><li>cliquer,</li><li>sélectionner,</li><li>pointer,</li><li>activer.</li></ul>Soit cinq mots différents pour la même action ! Cela nuit à compréhension de ce qu'il y a à faire. Pourquoi utiliser cinq mots différents pour la même action ? Quelle est la justification de ce manque flagrant d'homogénéité ? Le lecteur débutant peut facilement se perdre.<br /><br />Donc soyons clairs : <span style="font-weight: bold;">utilisez le même mot pour la même action</span>. Vous gagnerez en simplicité et en compréhension pour vos lecteurs.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-78249486832401034252009-03-29T12:50:00.011+02:002009-04-26T11:47:06.762+02:00Le manque de cohérence de l'interface des logiciels (3)<span style="font-weight: bold;">Un dernier billet (?) sur <a href="http://www.adobe.com/fr/products/dreamweaver/" target="_blank">Adobe Dreamweaver</a> et son manque de cohérence dans son interface</span><br /><br /><a onblur="try {parent.deselectBloggerImageGracefully();} catch(e) {}" href="http://www.adobe.com/fr/products/dreamweaver/?promoid=BPBMN" target="_blank"><img style="margin: 0pt 10px 10px 0pt; float: left; cursor: pointer; width: 44px; height: 42px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYZK3M38V2cKeZBm67bOf3_HQ2KL_zsL3HfP5jEdoLZLTAD3A7ej-6TfnwEGtx5WKEpaiTX7uNNtrPrh8B1EguLbM9FgpnLqQkGkfluSfM-yaUJKPSiUAL3fHkA9hQX-4vfg7aXNc8hco/s400/new-010.png" alt="informatique, interface, logiciel, écrire, livre, dreamweaver, " id="BLOGGER_PHOTO_ID_5318580105285264786" border="0" /></a>Ces billets ne sont pas une attaque en règle contre ce logiciel (que j'utilise professionnellement et sur lequel j'ai écrit plusieurs ouvrages), mais ils sont faits pour mettre en exergue la problématique du rédacteur face à des situations pas toujours simples à résoudre : comment faire passer simplement le message aux <span style="font-weight: bold;">lecteurs-utilisateurs</span> que <span style="font-weight: bold;">pour une même fonction plusieurs libellés peuvent être utilisés ?</span><br /><br />Prenons pour nouvel exemple les formulaires qui permettent de saisir des informations et de faire divers choix. Pour insérer un élément de choix (champ de texte, bouton radio, liste...) Dreamweaver utilise des identifiants (attribut <span style="font-weight: bold;">id</span> en code <span style="font-weight: bold;">HTML</span>). Dans la boîte de dialogue qui apparaît quand nous insérons un élément de formulaire, le champ de saisie <span style="font-weight: bold;">ID</span> a deux usages !<br />Quand il s'agit d'un <span style="font-weight: bold;">Champ de texte</span>, d'une <span style="font-weight: bold;">Liste</span>, d'un <span style="font-weight: bold;">Menu</span>... la saisie indiquée dans le champ ID sert bien à identifier de manière unique l'élément inséré. Par contre quand il s'agit d'un <span style="font-weight: bold;">bouton radio</span> la saisie du champ ID sert aussi à indiquer la valeur à envoyer au script serveur qui gère les données du formulaire.<br />Le problème est bien là : un champ de saisie pour deux usages différents que rien ne différencie dans la boîte de dialogue. Ce n'est pas si simple à expliquer et à utiliser pour le débutant.<br /><br />Deuxième exemple : une des techniques de mise en page des pages web utilise des "boîtes en position absolue" (boîte <div> en HTML). Avec Dreamweaver, cette technique s'appelle "les éléments en position absolue", les <span style="font-weight: bold;">éléments PA</span>. C'est par ce libellé, <span style="font-weight: bold;">Elément PA</span>, dans le menu et dans le panneau <span style="font-weight: bold;">Insertion</span> que nous pouvons y accéder. Mais, pour paramétrer cet élément PA, dans le panneau Propriétés, cela s'apelle <span style="font-weight: bold;">Elément CSS-P</span>.<br /><br />Toujours le même problème...<br /></div>Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-41220240378583332172009-03-24T08:06:00.010+01:002009-04-26T11:46:43.936+02:00Toujours faire appel à des fonctionnalités connues<span style="font-weight: bold;">Dans un livre, nous devons toujours faire appel à des fonctionnalités déjà étudiées, déjà connues.</span><br /><br /><img style="float:left; margin:0 10px 10px 0;width: 120px; height: 160px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgE3UmpwTQm9h3AGdtG45Zsk3atKNOkW0yCPlMhc6Oo1r_KdnzziBXFeb7F7ilUCxgGVCBqhsAWe4ttRIV4QuxRTsTp2DdNMu8Tt5ln-N-54TwBvV0pWURMvjmlVyl003J-XiU-LAClFtU/s200/new-014.png" border="0" alt="connu, informatique, lu, ordre, référence, écrire, livre,fonctionnalité"id="BLOGGER_PHOTO_ID_5318590813572606258" />Nous ne devons pas faire appel, ou parler d'une fonction que le lecteur verra plus tard : dans un paragraphe ou un chapitre suivant par exemple. Il n'est pas rare de lire une phrase contenant une fonctionnalité, un menu, une fenêtre, une technique que le lecteur connaîtra plus tard en lisant la suite de l'ouvrage.<br /><br />Par exemple, j'ai déjà lu ce genre de phrase : <span style="font-style: italic;">"Dans cette fenêtre, vous pouvez aussi ouvrir un modèle : cliquez sur l'option Modèle"</span>. Et de me dire : <span style="font-style: italic;">"Qu'est ce qu'un modèle ?"</span>. Pas un mot, pas une référence à la notion de modèle avant d'avoir lu cette phrase ! Et même immédiatement après, pas d'explication. Comment le lecteur peut savoir à l'avance ce qu'est un modèle ? S'il faut qu'il lise dix paragraphes ou qu'il atteigne le chapitre suivant avant de d'aborder cette notion, c'est perdu. Il faudra alors qu'il revienne x pages en arrière pour retrouver la première référence à cette notion de modèle. Ce n'est pas pédagogique.<br /><br />Le minimum que l'auteur puisse faire, c'est écrire explicitement que cette notion sera vue à telle page dans tel chapitre. Mais personnellement je pense que cela n'est jamais judicieux d'imposer des allers et des retours dans un livre.<br /><br /><span style="font-weight: bold;">C'est bien à l'auteur d'écrire sur des fonctionnalités vues et connues du lecteur. A l'auteur de structurer son ouvrage pour éviter ce type de maladresse rédactionnelle.</span>Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-37671138325593435912009-03-17T12:39:00.009+01:002009-04-26T11:45:44.475+02:00L'ordre dans le couple fonctionnalité vs accès<img style="margin: 0pt 10px 10px 0pt; float: left; width: 160px; height: 120px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjt4OSy92ZBtrgPqxyYf7uiY8TxALz2MAGHNQo0_Tq4L_5XJA6wyMtx2EybwUMm18vSgPla7yrZ19miUC8Pkoh07qB5JTEqF8kv_GDdoZYDHRgRTwD95NqT3z832dj1Jf_9xWKARNKGoR0/s200/new-015.png" alt="accès, fonctionnalité, informatique, objectif, écrire,livre" id="BLOGGER_PHOTO_ID_5318591653201160466" border="0" />Une petite réflexion me vient : dans quel ordre est-il plus judicieux d'indiquer l'objectif et l'accès d'une fonctionnalité ?<br /><br />Un exemple simple : dans le logiciel de mise en page <a href="http://www.adobe.com/fr/products/indesign/" target="_blank"><span style="font-weight: bold;">Adobe InDesign</span></a>, nous pouvons réaliser des tables des matières. Cette fonction est accessible dans le menu Texte.<br />Que devons-nous dire :<br />- <span style="font-style: italic;">C'est dans le menu Texte que vous pouvez créer une table des matières</span>,<br />- <span style="font-style: italic;">Pour créer une table des matières, allez dans le menu Texte</span>.<br /><br />Dans la première solution, je donne l'importance à l'accès, puisque je l'indique en premier. Inversement dans la deuxième solution, je donne l'importance à la fonctionnalité.<br /><br />Qu'en pensez-vous ? Que devons nous privilégier ? La fonctionnalité ou l'accès ? Pouvons nous même s'imposer une règle à respecter dans tout l'ouvrage ? Est-ce que cela peut largement varier tout au long du livre, pour éviter d'avoir un rédactionnel trop rigide ?Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-44442353713136169202009-03-15T12:43:00.010+01:002009-04-26T11:45:10.376+02:00Le manque de cohérence de l'interface des logiciels (2)Toujours sur le même sujet et toujours avec le logiciel <a href="http://www.adobe.com/fr/products/dreamweaver/" target="_blank"><span style="font-weight: bold;">Adobe Dreamweaver</span></a>, une autre incohérence sur les libellés des fonctionnalités.<br /><br /><a onblur="try {parent.deselectBloggerImageGracefully();} catch(e) {}" href="http://www.adobe.com/fr/products/dreamweaver/?promoid=BPBMN" target="_blank"><img style="margin: 0pt 10px 10px 0pt; float: left; cursor: pointer; width: 44px; height: 42px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYZK3M38V2cKeZBm67bOf3_HQ2KL_zsL3HfP5jEdoLZLTAD3A7ej-6TfnwEGtx5WKEpaiTX7uNNtrPrh8B1EguLbM9FgpnLqQkGkfluSfM-yaUJKPSiUAL3fHkA9hQX-4vfg7aXNc8hco/s400/new-010.png" alt="informatique, interface, logiciel, écrire,livre, dreamweaver" id="BLOGGER_PHOTO_ID_5318580105285264786" border="0" /></a>Cette fois, il s'agit des feuilles de style en cascade (CSS). Pour lier une feuille de style CSS à une page (X)HTML, nous pouvons le faire par quatre accès différents :<br />- par le menu : <span style="font-weight: bold;">Attacher feuille de style</span>,<br />- par un bouton : <span style="font-weight: bold;">Attacher une feuille de style</span>,<br />- par une barre de propriétés : <span style="font-weight: bold;">Joindre la feuille de style</span>,<br />- et en créant un nouveau document : <span style="font-weight: bold;">Lier le fichier CSS</span>.<br /><br />Quatre façons de procéder, quatre libellés différents, pour la même fonctionnalité !<br /><br />Et quand la fenêtre de dialogue apparaît, son titre est : <span style="font-weight: bold;">Ajouter une feuille de style externe</span>. Encore un libellé différent.<br /><br />Comment voulez-vous que le débutant s'y retrouve si pour la même fonctionnalité, l'interface lui indique des libellés à chaque fois différents ?Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-6349864815668288052009-03-14T16:54:00.007+01:002009-04-26T11:42:34.813+02:00Le chemin d'accès aux éléments d'interfaceDans un livre ou un tutoriel, il est très important de donner le chemin d'accès aux éléments d'interface dans l'ordre chronologique d'utilisation.<br /><br /><img style="float:left; margin:0 10px 10px 0;width: 160px; height: 120px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh_1xpU6SL_L8dbiYIYMsmrchAZ8IxJcK6xi3HO7FFidbO-YxQRvbTS7whzFDThVMZnh7N9Kle1rIi8gDq27cf6AGZcoLNJITFgbAxkygswd8buzzvvW3hshQj15yDX8gmf5Uh4wV9DQYA/s200/new-013.png" border="0" alt="consigne, informatique, interface, ordre, écrire,livre"id="BLOGGER_PHOTO_ID_5318588983286529506" />Si je dois indiquer l'utilisation de telle ou telle commande d'un menu, je commence par indiquer le nom du menu et pas l'inverse. Exemple : "<span style="font-weight: bold;">Allez dans le menu Fichier et choisissez Enregistrer</span>". Simple et logique dans l'ordre d'exécution.<br />Pas contre, si je dis "<span style="font-weight: bold;">Utiliser la commande Enregistrer que vous trouverez dans le menu Fichier</span>", l'utilisateur est obliger de lire complètement la phrase avant de pouvoir réaliser la consigne. L'utilisateur devra prendre la consigne à l'envers, il sera obligé de revenir au début de la phrase pour savoir où doit d'abord aller.<br />Dans <span style="font-style: italic;">Adobe Photoshop</span>, autre exemple respectant le chemin d'accès : "<span style="font-weight: bold;">Dans le menu Image, choisissez Taille de l'image. Dans la fenêtre Taille de l'image, dans la zone Dimension de pixel, dans le champ Largeur, saisissez la valeur souhaitée</span>". J'indique bien d'abord le menu, puis la commande de ce menu, le nom de la fenêtre qui est affichée, le nom d'une zone précise dans cette fenêtre et le nom du champ où doit se faire une saisie.<br />Et pas : "<span style="font-weight: bold;">Saisissez la valeur souhaitée dans le champ Largeur, pour y accéder, utilisez la commande Taille de l'image dans le menu Image</span>."<br /><br />Nous devons systématiquement indiquer l'ordre logique d'exécution dans une phrase la plus simple possible, en supprimant tous les mots inutiles à la compréhension de la phrase. De plus, chaque élément d'interface doit être parfaitement nommé (sujet d'un futur article).Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-2118714490788537862009-03-10T10:04:00.005+01:002009-04-26T11:41:47.970+02:00Le manque de cohérence de l'interface des logicielsLes libellés des logiciels sont parfois étonnants, pour parler "gentiment". Je prendrais comme premier exemple le logiciel de conception de site web <a href="http://www.adobe.com/fr/products/dreamweaver/" target="_blank"><span style="font-weight: bold;">Adobe Dreamweaver</span></a> (anciennement Macromedia).<br /><br /><a onblur="try {parent.deselectBloggerImageGracefully();} catch(e) {}" href="http://www.adobe.com/fr/products/dreamweaver/?promoid=BPBMN" target="_blank"><img style="margin: 0pt 10px 10px 0pt; float: left; cursor: pointer; width: 44px; height: 42px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYZK3M38V2cKeZBm67bOf3_HQ2KL_zsL3HfP5jEdoLZLTAD3A7ej-6TfnwEGtx5WKEpaiTX7uNNtrPrh8B1EguLbM9FgpnLqQkGkfluSfM-yaUJKPSiUAL3fHkA9hQX-4vfg7aXNc8hco/s400/new-010.png" alt="informatique, interface, logiciel, écrire,livre, dreamweaver" id="BLOGGER_PHOTO_ID_5318580105285264786" border="0" /></a>Quand vous insérez un tableau, vous pouvez sélectionner deux cellules pour en faire qu'une seule. C'est une fonctionnalité très classique. Là où je "râle", c'est l'incohérence des libellés des commandes pour accéder à cette fonctionnalité.<br />En passant par le menu, la commande est libellée : "<span style="font-weight: bold;">Fusionner les cellules</span>". Le libellé est court, simple et parfaitement compréhensible. En choisissant le bouton de raccourci correspondant, l'info-bulle qui apparaît au survol de la souris est : "<span style="font-weight: bold;">Combiner la sélection rectangulaire des cellules</span>".<br />Première remarque : pourquoi utiliser deux libellés différents, là où un seul suffit ? Le premier libellé est très clair !<br />Deuxième remarque : pourquoi utiliser des verbes d'action différents ? Fusionner ou Combiner ? Nous pouvons discuter pendant longtemps sur le sens de ces deux verbes, mais pourquoi deux choix ?<br />Enfin, pour le deuxième libellé l'utilisation de "sélection rectangulaire" est franchement difficilement compréhensible ! Comment une sélection dans un tableau peut être autrement que rectangulaire ? Qu'est-ce que le mot rectangulaire apporte de plus ? Rien !<br /><br />Tout cela complexifie inutilement l'interface utilisateur, surtout pour les novices.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0tag:blogger.com,1999:blog-8022835829471157350.post-77548899164007011882009-03-04T20:49:00.016+01:002009-04-26T11:41:02.637+02:00Comment s'adresser au lecteur<img style="width: 80px; height: 60px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhuk7G7dg9vY_gXzcm9k4KrrGavElTzxmXPoQgOOz154jV29IQDQPOwyq6dVCxYrlRU7_BMtbLgU7mxlbX7J51uopvCBOXVMy4Wi4KcqJqhTQI82FzltHAzRxlce4-VQVRpWdtc_TFSBQI/s200/new-012.png" border="0" alt="informatique, je, lecteur, nous, on, vous, écrire,livre"id="BLOGGER_PHOTO_ID_5318588132237731282" /><br /><span style="font-weight: bold;">Dans un ouvrage papier ou dans un tutoriel web, comment s'adresser au lecteur ?</span><br /><br /><span style="font-weight: bold;">Ne pas utiliser le on</span><br />Premier élément de réflexion : <span style="font-weight: bold;">le "on" est à proscrire</span> ! Pourquoi ? Parce que le "on" est tout ce qu'il y a de plus impersonnel ! C'est qui "on" ? Vous connaissez "on" ? A titre de provocation, l'adage bien connu "On est un con" est à retenir.<br />Il faut impérativement ouvrir le dialogue avec le lecteur et ce n'est pas en s'adressant à lui avec "on" que nous allons y arriver !<br /><br />Tiens, cela fait deux fois que je m'adresse directement à vous : j'ai d'abord utilisé <span style="font-weight: bold;">vous</span>, puis ensuite <span style="font-weight: bold;">nous</span><span> et je viens de dire <span style="font-weight: bold;">je</span>.</span><br /><br /><span style="font-weight: bold;">Utiliser le vous</span><br />Première possibilité : utilisez le "vous". Là je m'adresse directement à mon lecteur, je l'interpelle : "Hé vous, je vous parle ! Vous et moi communiquons, partageons ." Avec le "vous", j'en appelle à la réflexion de mon lecteur. Mais surtout, je rends acteur le lecteur : il doit agir. Le lecteur n'est plus passif.<br /><br /><span style="font-weight: bold;">Utiliser le nous</span><br />Deuxième possibilité : utilisez le "nous". Dans ce cas je l'adresse au lecteur et en même temps à moi-même. Je me fais "complice" du lecteur. Je l'interpelle pour que nous fassions un travail commun, pour que nous analysions ensemble un problème. Je me fais solidaire de mon lecteur.<br /><br /><span style="font-weight: bold;">Utiliser le je</span><br />Dans ce dernier cas, c'est bien moi qui m'adresse au lecteur, c'est moi qui parle. Je veux faire passer au lecteur un message : pourquoi j'ai fait cela, pourquoi je dis cela... Je m'expose, je m'engage.<br /><br />En guise de <span style="font-weight: bold;">petite conclusion</span>, les trois possibilités sont toutes à utiliser à bon escient. Il ne faut pas prendre qu'une seule locution, ce qui limiterait les formes d'écriture et d'expression. Il faut pouvoir varier et s'adresser au lecteur de différentes manières. C'est à la rédaction qu'il faut bien veiller à utiliser le bon pronom personnel, celui qui convient le mieux au contexte en cours de rédaction.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com1tag:blogger.com,1999:blog-8022835829471157350.post-32825307229942707042009-03-01T20:02:00.011+01:002009-04-26T11:40:31.594+02:00L'importance des titres dans les chapitres<img style="float:left; margin:0 10px 10px 0;cursor:pointer; cursor:hand;width: 160px; height: 106px;" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjCoQhm659VEAra0JcQ8zxLYVNRCl5y0tXePOoRPZ0SoVeZPpQlVVQ6oxArTS0aL6XZMkbqF_-N8E5XzX5kjXzfZUPtey1WOCf8WuIUsv6jUcJIcfCrmQ9frYfBIsfCTGpRqA6n7GNKx-A/s400/new-002.png" border="0" alt="chapitre, informatique, titre, écrire,livre"id="BLOGGER_PHOTO_ID_5328932599507240322" />Nous savons l'importance des titres pour les articles publiés sur Internet. Les lecteurs lisent d'abord les titres et seulement ensuite lisent le texte s'ils jugent le titre pertinent. Nous pouvons nous poser la question pour les ouvrages papiers. Les titres ne sont-ils pas aussi importants ?<br /><br /><span style="font-weight: bold;">Les fonctions d'un titre</span><br />- le titre doit structurer le chapitre,<br />- le titre doit indiquer ce qui va suivre,<br />- le titre doit donner envie de lire la suite.<br /><br /><span style="font-weight: bold;">Les titres structurants</span><br />Les titres sont faits pour structurer les chapitres d'un livre ou d'un tutoriel. Il faut donc que les <span style="font-weight: bold;">titres découpent le chapitre</span> de manière logique et pédagogique. La succession des titres doit refléter la démarche engagée dans le chapitre : d'où nous partons et où nous voulons aller, comment emmener le lecteur là où il doit arriver.<br /><br /><span style="font-weight: bold;">Les titres informatifs</span><br />De ce fait le libellé des titres doit impérativement donner l'aperçu de la structure du chapitre. Il ne faut pas écrire alors des libellés passe-partout, genre "Les principes", "La création", "Ajouter l'élément".<br />Le lecteur va se dire : Les principes de quoi ? La création de quoi ? Le titre doit se suffire à lui-même, il doit être <span style="font-weight: bold;">informatif</span> : il doit expliquer par ses propres mots ce qui va suivre. Rien qu'à lire les titres, le lecteur doit avoir un aperçu très clair de ce qu'il va lire et apprendre.<br /><br /><span style="font-weight: bold;">Les titres informatifs</span><br />Le titre doit être aussi <span style="font-weight: bold;">incitatif</span> : il doit donner envie de lire la suite du texte. Si dès le titre vous indiquez des mots et termes techniques, vous allez faire fuir le lecteur. Comment voulez-vous qu'il ait envie de lire quelque chose dont il ne comprend même pas les titres ? Il fait inciter le lecteur à lire la suite du texte, en employant des mots simples et compréhensibles dans le titre.Christophehttp://www.blogger.com/profile/14284646454510748159noreply@blogger.com0