tag:blogger.com,1999:blog-44700639151699826372024-03-05T07:10:53.364+01:00Minimalisme et DocumentationPour une documentation utile et efficace. Maîtriser les coûts de documentation.Minimalisme : éliminer le superflu. Respecter l'utilisateur et ne lui donner que l'information dont il a besoin.Se préparer au "DITA Authoring" et à la rédaction en mode "agile". Structurer les guides utilisateurs. Suivre la rédaction "orientée tâches". Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.comBlogger44125tag:blogger.com,1999:blog-4470063915169982637.post-33163142373500250862015-08-23T16:28:00.001+02:002015-11-04T13:16:41.247+01:00Mr Agile cooperating with Ms minimalism... <i><span style="font-family: "trebuchet ms" , sans-serif;">Are you planning to join an "Agile" team of developers? Any idea about the challenges when dealing with "Sprint", "User stories", "Scrum" ? </span></i><br />
<i><span style="font-family: "trebuchet ms" , sans-serif;"><a href="https://www.linkedin.com/profile/view?id=AAUAAAQr9NwBAYh5mw25k8D9uFkVmiPaRrSKAuM">Our colleague</a> <a href="mailto:paul.coinaud@gmail.com">Paul Coinaud</a><a href="mailto:paul.coinaud@gmail.com"> </a>-experienced "agile" technical author- agreed to share his know-how with us.</span></i><br />
<br />
<br />
<h2>
<span style="color: #660000; font-size: x-large;"><span style="font-family: "trebuchet ms" , sans-serif;">Let me tell you a (user) story...</span></span></h2>
<h2>
<span style="font-family: "trebuchet ms" , sans-serif;"></span></h2>
<span style="font-family: "trebuchet ms" , sans-serif;">Content management professionals’ daily activities are often constrained by the rythm imposed by engineers. This is particularly true when working with <i>s</i>oftware developers. </span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">Technical writers are "fed" with new features and the flow of delivery is not always very regular, especially when working with several development teams simultaneously. If several projects are released at the same time, you will clearly need to deal with a peak of work. This can also be variable due to the fact that some features require a lot of content to be created, while others require none.</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br />Since the arrival of <a href="http://agileprogramming.org/">Agile in Development teams</a>, in particular the <a href="https://en.wikipedia.org/wiki/Scrum_%28software_development%29">Scrum methodology,</a> the rythm is much more regular as the product functionalities are delivered drop by drop, following what we call sprints.</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<br />
<h3>
<span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;">SPRINT?... something for technical writers?</span></span></h3>
<h3>
<span style="font-family: "trebuchet ms" , sans-serif;"></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">Here is how a <a href="http://scrummethodology.com/scrum-sprint/">sprint</a> is sequenced. The Product Owner makes a list of User Stories (basically features) and prioritizes them in a backlog. A sprint planning allows dev teams to evaluate and implement the selected stories depending on their working capacity during the next Sprint (for example 3 weeks of sprint). So a set of stories is chosen and the devs will focus their work on these particular tasks.<br /><br />Every day, the devs meet in front of the sprint whiteboard for a stand up meeting called </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiNtHpspcFwFn-cMqfHGIHA_aTF84VZ4bWTrkewduNfVpm1hVnPPcyGS7Cqjdg6PqBIYJYVU6QZpilIHpxfb-pF53emWVzYxv4gO9HH51CKjJG3TXVNqAFnrwz4heZxCWWPpx8-9ipP4i0/s1600/Picture1.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="213" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiNtHpspcFwFn-cMqfHGIHA_aTF84VZ4bWTrkewduNfVpm1hVnPPcyGS7Cqjdg6PqBIYJYVU6QZpilIHpxfb-pF53emWVzYxv4gO9HH51CKjJG3TXVNqAFnrwz4heZxCWWPpx8-9ipP4i0/s320/Picture1.jpg" width="320" /></a></div>
<span style="font-family: "trebuchet ms" , sans-serif;"><a href="http://whatis.techtarget.com/definition/scrum-master">Scrum</a> – whence the name, to see the progression and raise any potential issue. The Technical Writers can be part of the Scrum to show the team their progression or to raise any issue related to the product or the content.<br /> <br />At the end of the sprint, the feature is normally shippable and the related technical documentation should also be ready at this stage. This means the tech writers really work hand in hand with the dev team and their <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_12">work needs to be synchronized </a>as much as possible to ship a product with a decent documentation on time.<br /><br /><span id="goog_1966559730"></span><span id="goog_1966559731"></span>So as the sprint goes, the documentation must follow the progression. </span><br />
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg0XtmJ9kJGoDE9MiuUaSzaUWfrOfy5Pb2e0tcmwwK95YOApaiT95lV1KOqIN3vN6GdJYmRf3o99vy9_-j-mxmzhcUgXbsHMFYHE6iqSd7opo1g8uvdzO_WnC2EMmGzseeYx04X0THfvCw/s1600/picture2.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="132" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg0XtmJ9kJGoDE9MiuUaSzaUWfrOfy5Pb2e0tcmwwK95YOApaiT95lV1KOqIN3vN6GdJYmRf3o99vy9_-j-mxmzhcUgXbsHMFYHE6iqSd7opo1g8uvdzO_WnC2EMmGzseeYx04X0THfvCw/s200/picture2.jpg" width="200" /></a><span style="font-family: "trebuchet ms" , sans-serif;">This gives the techwriters a well-defined working environment, with concrete tasks to perform and clear deadlines.</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">So let's say it, a little bit of pressure, but we all like to work under pressure, right</span>?<br />
<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<div class="separator" style="clear: both; text-align: center;">
</div>
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<br />
<h3>
<span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;">SPRINT and minimalism?</span></span></h3>
<h3>
<span style="font-family: "trebuchet ms" , sans-serif;"></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">Of course the <a href="http://users.edte.utwente.nl/meij/minimalism.htm">Minimalist approach</a> is an evidence here. When creating content with short deadlines, you need to focus on two things:</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br />- As soon as possible during the sprint, tech writers need to work with the devs to make sure the quality of the User Interface is good enough: improve the error messages, correct</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgObs6mSv9X65mlQ9SzqLzew_GdWTdiIahqLz1vQfbXXEbS1SbJXdimNlVX9EQyd38m4mIwLE_Xg9Ah8U81i7FeDGrnYYU8jKoUzs4lxHonSg3QreY4cGxrc9FLT6cwyAzJf_1E3tqLQBM/s1600/picture3.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgObs6mSv9X65mlQ9SzqLzew_GdWTdiIahqLz1vQfbXXEbS1SbJXdimNlVX9EQyd38m4mIwLE_Xg9Ah8U81i7FeDGrnYYU8jKoUzs4lxHonSg3QreY4cGxrc9FLT6cwyAzJf_1E3tqLQBM/s1600/picture3.jpg" /></a></div>
<span style="font-family: "trebuchet ms" , sans-serif;">mistakes in the labels (geeks love typos!) and if possible, improve the ergonomics as well. A structured product with clear error messages is reducing the probability for the user to require assistance. Plus, it will also be easier and faster to create content around this.</span><br />
<br />
- <span style="font-family: "trebuchet ms" , sans-serif;">Create the information people really need:</span><br />
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;">Focus on task oriented content, procedures that will help users accomplish their tasks. </span></li>
<li><span style="font-family: "trebuchet ms" , sans-serif;">Don’t forget to <a href="http://minimalist-doc.blogspot.fr/2013/07/utilisateurs-stupides-et-redacteurs.html">respect the users' level of expertise</a> </span></li>
<li><span style="font-family: "trebuchet ms" , sans-serif;">If you feel like a beginner will need more contextual information before going on with tasks, add a little bit of conceptual information here. A drop. </span></li>
</ul>
<span style="font-family: "trebuchet ms" , sans-serif;"> <br />Not only Minimalism and Agile principles are compatible, but if you need to create technical content, it will definitely help you focus on what matters for the end users: task-oriented content, quality user interfaces and <a href="http://minimalist-doc.blogspot.fr/2014/08/section-troubleshooting-comment-faire.html">helpful error messages</a> with an easy access to the related help topics. </span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">All this combined with regular feature deliveries is the key to content management success in a software company!</span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com12tag:blogger.com,1999:blog-4470063915169982637.post-91949676947388877862015-05-26T22:33:00.001+02:002016-02-10T19:54:27.163+01:00Minimalist documentation is not a suitcase!<h3>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>Designing minimalist documentation is increasingly in demand. In particular, due to documentation experts <a href="http://www.oxygenxml.com/dita/styleguide/webhelp-feedback/Artefact/Authoring_Concepts/c_Minimalism.html">migrating their content to DITA.</a></i></span></span></h3>
<h3>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i> </i></span></span></h3>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Not surprising, aliens now decide to board the train of minimalism ... and miss the step because <a href="http://www.tcworld.info/e-magazine/technical-communication/article/pack-less-provide-more-what-ultra-light-travel-has-taught-me-about-minimalism-in-documentation/">minimalism is not a suitcase! </a></span></span><br />
<h2>
<span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">What is minimalism?</span></span></span></span></h2>
<h4>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></h4>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>"Minimalism consist in identifying the <a href="http://dita-ot.sourceforge.net/doc/ot-userguide13/xhtml/faqs/topic_authoring.html">smallest amount of instruction</a> that allows for the successful completion of a task </i>"<br /> </span></span><br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">In other words, providing the<a href="http://users.edte.utwente.nl/meij/minimalism.htm"> minimal dose of information</a> for the user to reach his goal.<br />Not cutting words, using icons or pouring safety and security measures on your website and in all of your content...</span></span><br />
<br />
<h2>
<span style="font-weight: normal;"><span style="font-size: large;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">What's in this minimalist suitcase?</span></span></span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: large;"> </span></span></span></h2>
<ul>
<li>
<span style="color: #274e13;"><b><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-weight: normal;"><span style="font-size: large;">Re-use</span></span></span></span></b><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b> <u> </u></b> </span></span><u><span style="color: #274e13;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><br /></span></span></u><br />
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">The <a href="https://www.facebook.com/leah.guren">suitcase owner </a>suggests to</span> <span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>"think about the multi-use value of a piece of information. A well-designed graphic, for<span style="font-size: small;"><span style="font-weight: normal;"> example, can be useful in multiple topics." </span></span></i></span>
</li>
</ul>
<ul></ul>
<blockquote class="tr_bq">
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh6DmSqJl3dwWpftMmHrYFdiPzjRHo3lyzIwr_21gDkOtjmv1IVz9GzFBu0HvQSh1gpRI3tYHJpUIzy8uNR2jVG6ajat-UIJJqas1M5MwFIKeOgXJ-4y1Op3v1dnEYodoM6cBUPDEOQ_0M/s1600/Reuse.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh6DmSqJl3dwWpftMmHrYFdiPzjRHo3lyzIwr_21gDkOtjmv1IVz9GzFBu0HvQSh1gpRI3tYHJpUIzy8uNR2jVG6ajat-UIJJqas1M5MwFIKeOgXJ-4y1Op3v1dnEYodoM6cBUPDEOQ_0M/s200/Reuse.jpg" width="191" /></a></div>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Unfortunately, documentation re-use does not belong to the minimalism approach. Saving documentation cost by re-using topics is the main goal of a DITA implementation.</span></span><br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><br />Minimalism was developed in the late eighties by researchers in <b>cognitive science</b>. It focused on the <b>USER's needs</b> for information on performing a task.<br /> </span></span><br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">DITA development started in 2001 with </span></span><b><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">IB</span></span></b><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b>M developers</b> looking to reduce documentation costs by re-using content. This was a <b>business-oriented</b> authoring perspective, not user-oriented.</span></span></blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">You can design a "minimalist" user guide without considering content re-use!</span></span></blockquote>
<ul>
<li><span style="color: #274e13;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif; font-size: large;">Universally appealing design </span><u><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif; font-size: large;"> </span><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif; font-size: large;"><br /></span></u></span></li>
</ul>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">The author stresses:<i> "For documentation: always select a design and style that is universally appealing </i></span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>(or at least inoffensive) and will not cause problems during localization."</i></span></span></blockquote>
</blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">It would be interesting to see an example of a "universally appealing" piece of</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgryCZP7hEAIkcbRCaHEkx8R0u_G8c1VtC4RNIryvikdBO-EpY3Dtu_LdvLyn4TDNiJS46ixlkLG4m6rHDTTaffKOMGqIcKJLeYn1kas-8CknvbsOVhToUZq4TuERiBFePPci8s-MfDmS8/s1600/How+to+Make+Your+Website+Multi-Culturally+Accessible%255B5%255D.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="191" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgryCZP7hEAIkcbRCaHEkx8R0u_G8c1VtC4RNIryvikdBO-EpY3Dtu_LdvLyn4TDNiJS46ixlkLG4m6rHDTTaffKOMGqIcKJLeYn1kas-8CknvbsOVhToUZq4TuERiBFePPci8s-MfDmS8/s200/How+to+Make+Your+Website+Multi-Culturally+Accessible%255B5%255D.jpg" width="200" /></a></span></span></div>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> user's documentation. </span></span></blockquote>
<blockquote>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Indeed, our colleague Ron Blicq demonstrates that publishing for the US, UK, Australia, etc </span></span></blockquote>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">"<i><a href="http://technicalcommunicationuk.com/index.php/archives/4701">means tackling many more differences </a>than just changing the spelling and general terminology... Readers who encounter expressions </i></span></span><i><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">that can be misinterpreted or simply not understood may downplay the importance of the information or comment disparagingly on the writer’s capability as a communicator."</span></span></i></blockquote>
</blockquote>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">If writing for an English-speaking (mother tongue) audience spread over several continents is challenging, how do you provide universally appealing documentation for multi-lingual audiences?</span></span></blockquote>
</blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i><a href="http://www.acrolinx.com/webinars/why-theres-no-such-thing-as-neutral-content-webinar/"></a></i></span></span></blockquote>
<blockquote>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">BTW, minimalism never considered localisation... although we could include it in "helping the user to perform a task <b> in the user's language. "</b></span></span></blockquote>
<ul>
<li><span style="color: #274e13;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif; font-size: large;">Layer </span></span></li>
</ul>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>"For documentation: don’t try to dump all information onto the user at once. Layer it with techniques like DHTML, allowing the user to reveal information as needed." </i></span></span></blockquote>
</blockquote>
<blockquote class="tr_bq">
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiMp2WY7owbXEovTDD5O3Jq34CjDZX-RZsNEsS6dsU_t3yYndoklrHXWxci7VTm4vql4OyX_B220Ga7dBUwLeCKYZ3XADa-UgpJ9cqzDqQnOAsYp9qZR22h09u5B6nkWvokdo2odflCZgM/s1600/paper-clutter_plancher.gif" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="115" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiMp2WY7owbXEovTDD5O3Jq34CjDZX-RZsNEsS6dsU_t3yYndoklrHXWxci7VTm4vql4OyX_B220Ga7dBUwLeCKYZ3XADa-UgpJ9cqzDqQnOAsYp9qZR22h09u5B6nkWvokdo2odflCZgM/s200/paper-clutter_plancher.gif" width="200" /></a></div>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Why <a href="http://en.wikipedia.org/wiki/Dynamic_HTML">DHTLM</a>? How to prevent "<i>dumping all information onto the user at once</i>" in a paper document (i.e. without DHTML)?</span></span><br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></span></span></blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Users
of minimalist documentation don't need DHTML to quickly find the
information they need. Thanks to a clear and precise Table Of Contents and a carefully designed Index (based on
meaningful titles), they quickly find the small piece of information they are looking for.</span></span></span></span></blockquote>
<blockquote class="tr_bq">
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">In addition, a minimalist document increases findability (i.e. "revealing information") because</span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> "<i>Minimalism means [creating] small non-linear <a href="http://dita.xml.org/book/export/html/1047">chunks readable in any order</a>" </i></span></span></blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Minimalism authoring does not need TOOLS such as DHTML, it needs the author's BRAIN!</span></span></blockquote>
<ul>
<li><span style="color: #274e13;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: large;">Compress to icon </span></span><u><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: large;"> </span></span></u></span></li>
</ul>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>"Think
of ways that you can compress content to get it out of the way; for
example, DHTML or graphics that can compress to a small icon when
clicked." </i></span></span></blockquote>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgcLE5N-72CaHWoyijmPvnFKDYLomCrwyJH7sEvGrxqGnzRya2EO4wybK2PAy5ev2TmTO8eKKgIHQN4bn2nYTwN6ti1Qyd_aLID9qK-k-T_M14-KZGLDKphLv3hsOGcTnHIAKkYBUw2HeE/s1600/url_icon_Man.png" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgcLE5N-72CaHWoyijmPvnFKDYLomCrwyJH7sEvGrxqGnzRya2EO4wybK2PAy5ev2TmTO8eKKgIHQN4bn2nYTwN6ti1Qyd_aLID9qK-k-T_M14-KZGLDKphLv3hsOGcTnHIAKkYBUw2HeE/s200/url_icon_Man.png" width="147" /></a></div>
<blockquote class="tr_bq">
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Using icons to compress content? This brings two questions:</span></blockquote>
<blockquote class="tr_bq">
<ul>
<li><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Does this help the user reach his objective? </span></span></li>
</ul>
</blockquote>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b>No,</b> because users hardly understand the <a href="http://www.nngroup.com/articles/icon-usability/">meaning of an icon:</a></span><i><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">"Most icons continue to be ambiguous to users due to their association with different
meanings across various interfaces. This absence of a standard hurts
the adoption of an icon over time, as users cannot rely on it having the
same functionality every time it is encountered."</span></span></i></blockquote>
</blockquote>
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Does this reduce the amount of content? </span></li>
</ul>
</blockquote>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b>No,</b> because icons are useless if you have to explain them.You are just <a href="http://wiki.servicenow.com/index.php?title=Understanding_Icons_in_the_Interface#gsc.tab=0">adding graphics to text:</a></span><i>"<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Due to the absence of a standard usage for most icons, text labels are necessary to communicate the meaning and reduce ambiguity."</span></span></i></blockquote>
</blockquote>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Therefore, are we using icons to help users find the right information ...or just adding more confusion to the documentation?</span></blockquote>
</blockquote>
<ul>
<li><u><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif; font-size: large;"><u><span style="color: #274e13;">Critical info</span></u> </span></u></li>
</ul>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">The <a href="http://www.cowtc.com/training-services.html">author</a> stresses<i>:"For documentation: make sure that your users can find the critical info, such as your company contact info, quickly. Include safety and security measures on your website and in all of your content."</i></span></span></blockquote>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEioDaIbSgXldLdMtWP9XG4_XZyhRdZ2yUKNqHOO7FBuduquSlDjd4Q8MwIyw8V56bFXYjICeNT1Azb2j4ACSVA7O2iOYiP_YqhZimk_pSm7sUCqqk9_k6xlWJYR11wA0T37GaG6JuR3nJE/s1600/WarningSign.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="161" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEioDaIbSgXldLdMtWP9XG4_XZyhRdZ2yUKNqHOO7FBuduquSlDjd4Q8MwIyw8V56bFXYjICeNT1Azb2j4ACSVA7O2iOYiP_YqhZimk_pSm7sUCqqk9_k6xlWJYR11wA0T37GaG6JuR3nJE/s200/WarningSign.jpg" width="200" /></a></div>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Are we sure the end-user is going to look for critical info on the website ? Why do we publish paper manuals? </span></span></blockquote>
<blockquote>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Research has demonstrated that putting safety measures <i>"in all of your content</i>" is counterproductive. <span id="goog_384636871"></span><span id="goog_384636872"></span>In <a href="http://www.nngroup.com/articles/information-pollution/">"Warning: Superfluous Warnings Are Hazardous</a>" </span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Jakob Nielsen reveals:</span></span> </span></span><br />
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>"Most instruction manuals are littered with "important" warnings that caution against obvious stupidities, burying actual dangers amid a mass of irrelevancy . </i></span></span><br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>An out-of-control legal system has made a joke of the entire warnings concept; products are now less safe because nobody bothers to read warnings anymore"</i></span></span></blockquote>
</blockquote>
<blockquote>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></blockquote>
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">BTW, the user NEVER opens the manual to search for a warning message. He just wants an information to perform a specific task <b>safely</b>. He wants clear instructions. He does not want to be frightened.</span></span></blockquote>
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-weight: normal;"><span style="font-size: large;"><span style="color: #990000;"> </span></span></span></span></span></h2>
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-weight: normal;"><span style="font-size: large;"><span style="color: #990000;">Dancing the tango with your suitcase<span style="color: #274e13;"> <span style="color: #990000;">(</span></span></span></span></span><a href="http://www.wikihow.com/Dance-the-Tango">one step forward, two-step backwards</a>) </span></span></h2>
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b>In 2013</b> the author explained why <a href="http://www.tcworld.info/e-magazine/technical-communication/article/minimalism-in-documentation/events/feed/">minimalism fails</a>.One reason was: </span></span><br />
<blockquote class="tr_bq">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> </span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">"<i>because [users] don’t understand big conceptual issues, such as the internal </i></span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgW-LCyDxCIlT4BGxRGYa_tq1Mq9YUX3_XiUF_a01XEV2544VFWcu6xSgY7EefHfSv0dM6Ng8A6GnjERJYwlqXUWS9gTDoRtYlbzRC4Y-aP6D0w33D4NyvMIT5oZN7AXiyLwc1yLPTzFRg/s1600/turn_Around.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="197" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgW-LCyDxCIlT4BGxRGYa_tq1Mq9YUX3_XiUF_a01XEV2544VFWcu6xSgY7EefHfSv0dM6Ng8A6GnjERJYwlqXUWS9gTDoRtYlbzRC4Y-aP6D0w33D4NyvMIT5oZN7AXiyLwc1yLPTzFRg/s200/turn_Around.jpg" width="200" /></a></i></span></span></div>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><i>mechanisms of the product."</i></span></span></blockquote>
<br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Sorry, but I don't understand how my good-old-car works. This does not prevent me from driving it to a <a href="http://www.informationenergy.org/">smart conference</a>.</span></span><br />
<br />
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><b>Mid-2015</b>, when everybody is showing enthusiasm for minimalism, she makes a nice 180 degree turn advocating for minimalism... Dancing the tango with a suitcase?</span></span><br />
<br />
<h2>
<span style="font-weight: normal;"><span style="font-size: large;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Minimalism outside the suitcase</span></span></span></span></h2>
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">To pack your suitcase with effective and efficient minimalism guidance, you could start by <span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">following </span>two (genuine) "minimalism" gurus:</span></span><br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjaTsCkN8pRtas6pV_IjFaLfqJmWPRL0kkIwvGunpjPbM6k1a0nJYWVxgpR1kxFsUQOiMGNvaHi22UozGa8gyQE7SisuvVJsMrUlkgcY6jXwN7EQRjV0ZsySOhJZJaKUIXbMH0dJItEeQM/s1600/John_Carroll.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjaTsCkN8pRtas6pV_IjFaLfqJmWPRL0kkIwvGunpjPbM6k1a0nJYWVxgpR1kxFsUQOiMGNvaHi22UozGa8gyQE7SisuvVJsMrUlkgcY6jXwN7EQRjV0ZsySOhJZJaKUIXbMH0dJItEeQM/s200/John_Carroll.jpg" width="133" /></a></div>
<br />
<br />
<br />
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg7Di8D00Ii9XnCBoD-njz5O85OjINd2DhOqCqOPfLQoFn1mHbUo9N1omZRF6O-toq4COSrrp15h09IFrx4cTe3RLoJW9LqVUau8qcPk_6sVLEezlHLpg5Xde6AjdllJojIhYegesPlkFk/s1600/H_VanDerMeij.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg7Di8D00Ii9XnCBoD-njz5O85OjINd2DhOqCqOPfLQoFn1mHbUo9N1omZRF6O-toq4COSrrp15h09IFrx4cTe3RLoJW9LqVUau8qcPk_6sVLEezlHLpg5Xde6AjdllJojIhYegesPlkFk/s200/H_VanDerMeij.jpg" width="150" /></a><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><a href="http://notebook.stc.org/recognition-monday-john-carroll-named-honorary-fellow/">John Carroll</a> (receiving an Award at STC annual conference June 2015... time to listen to him!)</span></span><br />
<br />
<br />
<div style="text-align: right;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><a href="http://www.infomanagementcenter.com/publications/e-newsletter/information-management-news-12-15/hans-van-der-meij-demonstrates-at-dita-europe-that-minimalism-is-alive-and-well/">Dr. Hans van der Meij,</a> </span></span></div>
<div style="text-align: right;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">keynote speaker at </span></span></div>
<div style="text-align: right;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">DITA Europe 2015 conference</span></span></div>
<br />
<div style="text-align: right;">
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> <a href="http://users.edte.utwente.nl/meij/actionoriented.htm"></a></span></span><b><span style="color: #660000;"><span style="font-size: large;"><span style="font-weight: normal;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">__________________________________________________________</span></span></span></span></b></div>
<h3>
<span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Essential further reading</span></span></span><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> </span></span></span></span></h3>
<ul>
<li><span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="color: black;"><span style="font-size: small;"><a href="http://www.infomanagementcenter.com/Resources/eNews2012-12JHackos.pdf">Minimalism updated 2012</a>, <a href="http://en.wikipedia.org/wiki/JoAnn_Hackos">JoAnn Hackos</a> - time to check your knowledge about minimalism!</span></span></span></span></span></span></li>
<li><span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="color: black;"><span style="font-size: small;"><a href="http://www.infomanagementcenter.com/enewsletter/2012/201206/third.htm">Three new misconceptions about Minimalism</a> ("Too Big To Know"?), <a href="http://blog.joepairman.com/">Joe Pairman</a> - time to sit down and stop "writing fluff"...</span></span></span></span></span></span></li>
</ul>
<span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="color: black;"><span style="font-size: small;"> </span></span></span></span></span></span><b><span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="color: black;"><span style="font-size: small;"><span style="color: #660000;"><span style="font-size: large;"><span style="font-weight: normal;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">_____________________________________________________</span></span></span></span></span></span></span></span></span></span></b><br />
<h2>
<span style="color: #660000;"><span style="font-size: large;"><span style="font-weight: normal;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;">Getting trained in minimalism</span></span></span><span style="font-size: large;"><span style="font-weight: normal;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"> </span></span></span></span></span></h2>
<span style="font-size: large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="color: black;"><span style="font-size: small;">If you want to know more about minimalism, check<span style="color: #990000;"> </span></span></span></span></span></span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_8&zenid=30jg96onpcdkfm7kgd00g4bn70">these workshops</a></span></span><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><a href="http://www.informationenergy.org/nl/minimalism-for-authoring/"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"></span></span></a><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> <span style="font-weight: normal;">and add this<a href="http://www.amazon.co.uk/Minimalism-Beyond-Nurnberg-Funnel-Carroll/dp/0262512955/ref=sr_1_1?s=books&ie=UTF8&qid=1432667811&sr=1-1&keywords=minimalism+beyond+the+Nurnberg+Funnel"> book to your suitcase</a>!</span> </span></span></span></span><br />
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> </span></span></span></span></h2>
<h2>
<span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"><span style="font-size: small;"><span style="font-family: "helvetica neue" , "arial" , "helvetica" , sans-serif;"> </span></span></span></span></h2>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com3tag:blogger.com,1999:blog-4470063915169982637.post-62591587181943260332015-03-12T21:05:00.001+01:002015-08-08T09:21:43.123+02:00Le boss qui dit NON (formation continue)<span style="font-family: "Trebuchet MS",sans-serif;">Parfois les managers, chefs de projets, directeurs, "Head of..." manquent d'arguments pour refuser, aux membres de leur équipe, une formation/une participation à un congrès professionnel, à un salon.<br /><br />On peut les aider. Voici cinq arguments...</span><br />
<h2>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"><span style="font-size: x-large;"><b>__________________________________</b></span></span> <span style="font-size: x-large;"><span style="color: #660000;"><span style="font-weight: normal;">1. Manque de temps </span></span></span></span></h2>
<div style="text-align: right;">
<br /></div>
<div class="separator" style="clear: both; text-align: center;">
<span style="color: #274e13;"><span style="font-size: x-large;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjdPpLazfhIREuOnjoxNEash5sApD-owt4OFNDoGzNvdKzuJ4lkBVzwXXXkxjG92JzAf9cLdd4er4Q4xSV0w3_urAuJZe8zgaKjCvFvxgz80LbKuHkiUGyfZZfDclkiKdUW4wjwBDZv5yo/s1600/TooBusyForTaining.jpeg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="260" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjdPpLazfhIREuOnjoxNEash5sApD-owt4OFNDoGzNvdKzuJ4lkBVzwXXXkxjG92JzAf9cLdd4er4Q4xSV0w3_urAuJZe8zgaKjCvFvxgz80LbKuHkiUGyfZZfDclkiKdUW4wjwBDZv5yo/s1600/TooBusyForTaining.jpeg" width="400" /></a></span></span></span></div>
<br />
<br />
<br />
<br />
<span style="color: #274e13;"><span style="font-size: x-large;"><span style="color: black;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: small;">"On n'a pas le temps, on doit livrer 2 manuels à la fin du mois"</span></span></span></span><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<br />
<span style="color: #274e13;"><span style="font-size: x-large;"><b>_________________________________________</b></span></span><br />
<span style="color: #660000;"><span style="font-size: x-large;"><span style="font-family: "Trebuchet MS",sans-serif;">2. Manque de budget</span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">"La situation économique est telle que nous avons d'autres priorités"</span><br />
<div style="text-align: right;">
<span style="font-family: "Trebuchet MS",sans-serif;">[<span style="font-family: "Courier New",Courier,monospace;">par exemple, produire de la documentation que personne ne li</span>t]</span></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><i> Avez-vous seulement jeté un oeil sur le budget "formation" de votre entreprise ?</i></span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><i> Savez-vous que votre entreprise COTISE déjà auprès des organismes de collecte (OPCA) ? </i></span> <i><span style="font-family: "Trebuchet MS",sans-serif;">Les fonds sont DEJA verses. Qui va maintenant les utiliser ?</span></i></li>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;"><i></i></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><i><span style="font-family: "Trebuchet MS",sans-serif;"> </span></i></span><span style="font-family: "Trebuchet MS",sans-serif;"><i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"><span style="font-size: x-large;"><b>__________________________________</b></span></span></span> </i><br /><br /><span style="color: #660000;"><span style="font-size: x-large;">3. Manque de programme de formation</span></span><br />"On n'a pas de programme, donc on ne fait rien"</span><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhdS65ds5OqQatLgpK8tbfAzdbo4D_ltm1j-t99KcIKf1RkSfRzr2YfXJRDSvS_0wteTjPpoXDD-oZVvxYdGVXB_atjiDNJSjTtD_upWmNHY8PT3mwRrjo8W_TM_V1LyMPlbj_EBHTx02k/s1600/formation-16-mm.gif" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="304" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhdS65ds5OqQatLgpK8tbfAzdbo4D_ltm1j-t99KcIKf1RkSfRzr2YfXJRDSvS_0wteTjPpoXDD-oZVvxYdGVXB_atjiDNJSjTtD_upWmNHY8PT3mwRrjo8W_TM_V1LyMPlbj_EBHTx02k/s1600/formation-16-mm.gif" width="320" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span><i><span style="font-family: "Trebuchet MS",sans-serif;"> </span></i><br />
<br />
<ul>
<li><i><span style="font-family: "Trebuchet MS",sans-serif;">... mais vous avez une obligation de formation vis-à-vis de vos salariés (loi de Mars 2014). Vous devez leur offrir une possibilité de formation tous les deux ans, sinon vous êtes passible d'u</span><span style="font-family: "Trebuchet MS",sans-serif;">ne amende</span></i></li>
</ul>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"><span style="font-size: x-large;"><b>___________________________________</b></span></span><span style="color: #660000;"><span style="font-size: x-large;"> 4. Manque d'agrément comptable</span></span><br />"Pour financer un déplacement du salarié à un congrès, je vais essuyer un refus de la compta. Pas question de m'engager sur ce terrain-là"</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<ul>
<li><i><span style="font-family: "Trebuchet MS",sans-serif;">Savez-vous seulement qu'il existe, dans le plan comptable, un compte 625 - Déplacements, missions ? Il n'est pas nécessaire de réserver</span> <span style="font-family: "Trebuchet MS",sans-serif;">ce compte aux dépenses somptuaires des cadres supérieurs se rendant à leur congrès aux Maldives.</span></i></li>
</ul>
<i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"><span style="font-size: x-large;"><b>___________________________________</b></span></span></span></i><span style="font-family: "Trebuchet MS",sans-serif;"><br /><span style="color: #660000;"><span style="font-size: x-large;">5. Le pouvoir de dire NON</span></span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjDZKmIwHJuJKR5NqqYYf7SN8MapZb0q5E9fSwriA4joLFZMoJ9cs_afIWcxZ120qCVuRxh1Lsjt31QzIMa-zH7MPm1zMGDVIoOZUkwpUe3M-uMoMDNxPJuWqaLmqD_RKP4PXk4G9QYEUk/s1600/non_Dire.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjDZKmIwHJuJKR5NqqYYf7SN8MapZb0q5E9fSwriA4joLFZMoJ9cs_afIWcxZ120qCVuRxh1Lsjt31QzIMa-zH7MPm1zMGDVIoOZUkwpUe3M-uMoMDNxPJuWqaLmqD_RKP4PXk4G9QYEUk/s1600/non_Dire.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">C'est ce qui fait un vrai boss : utiliser son pouvoir de dire NON ! Ca le distingue de la valetaille (qui, elle, doit toujours acquiescer). </span><br />
<br />
<span style="color: #274e13;"><span style="font-size: x-large;"><span style="color: black;"></span><b>______________________________________</b></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;"><span style="font-size: x-large;">Calendrier</span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">Les prochaines réunions, conférences, congrès professionnels sont d'excellentes occasions de maintenir </span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">à flot</span> ses compétences en documentation technique :</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Atelier <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_8">"Documentation minimaliste" </a>Outre-Atlantique</span></li>
<li><span style="font-family: "Helvetica Neue",Arial,Helvetica,sans-serif;">Master Clas<a href="http://www.informationenergy.org/minimalism-for-authoring/">s "Minimalist authoring</a>" à Paris le 7 septembre </span></li>
</ul>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"> ... Et si vous invitiez votre boss à vous accompagner à l'un de ces ateliers ?</span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-11499143751016039732015-02-25T21:04:00.001+01:002015-11-04T13:17:50.776+01:00Minimalisme : A la recherche de l'info perdue...<h2>
</h2>
<span style="font-family: "trebuchet ms" , sans-serif;">Le 4e principe du minimalisme nous recommande "<a href="http://users.edte.utwente.nl/meij/supportvarioususes.htm">Support reading to do, study and locate</a>". On s'arrêtera sur la phase "localiser/trouver" (l'information pertinente).<br /> </span><span style="color: #274e13;"><span style="font-size: x-large;"><b></b></span></span><br />
<h3>
<span style="font-weight: normal;"><span style="color: #660000; font-size: x-large;"><span style="font-family: "trebuchet ms" , sans-serif;">Trouver rapidement </span></span><span style="color: #990000; font-size: large;"><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;"><span style="font-size: x-large;">l'info exacte</span> </span></span></span></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">Prenez Alcibiade, principal rédacteur chez SnowDamm, fabricant de <a href="http://france3-regions.francetvinfo.fr/alsace/2014/12/31/les-canons-neige-du-ballon-d-alsace-font-long-feu-le-gestionnaire-de-la-station-porte-plainte-622122.html">canons à neige,</a> qui a terminé "son" manuel opérateur. 350 pages, mise en page très carrée, formatage de première classe et délais maintenus à 100%. <br /><br />Grande satisfaction... et, subitement, la Tuile !<br /> </span><br />
<span style="font-family: "trebuchet ms" , sans-serif;">Accident corporel autour d'un des canons à neige : l'opérateur a la main coupée. S'ensuit la réclamation du client : c'est de la faute du matériel (et du manuel).<br /><br />Chez SnowDamm, c'est l'alerte au niveau du management : a-t-on bien mentionné, dans la documentation, comment graisser les disques XYZ-23 ?</span><br />
<br />
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhwK61Iru3FnapYvkNWQfNRQtgoK5JdPiK6JFnbSlW1i-BbwQRC_cVon18EgRz12NTes5wG-3pNLSKucCYGNmK7DN4M53paywG1O2r8MKghe_REgLvLLiF0kPrjwTNZmhUq72QgZoyHTWY/s1600/anxiety-150x150.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhwK61Iru3FnapYvkNWQfNRQtgoK5JdPiK6JFnbSlW1i-BbwQRC_cVon18EgRz12NTes5wG-3pNLSKucCYGNmK7DN4M53paywG1O2r8MKghe_REgLvLLiF0kPrjwTNZmhUq72QgZoyHTWY/s1600/anxiety-150x150.jpg" /></a><span style="font-family: "trebuchet ms" , sans-serif;">Sueurs froides chez le rédacteur : <i>"euhhh, oui,... Anastase, l'ingénieur, m'en avait parlé, donc je l'ai mis dans la doc !"</i></span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">"<i>Oh, Alcibiade ! apportez-moi la preuve. La documentation, sur mon bureau ! Tout de suite ! On court au procès ici ! Dépêchez-vous </i>!" s'énerve le boss</span>.<br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">OUF ! Le rédacteur avait bien mentionné la manip' pour graisser correctement les disques. Alcibiade est un homme tranquille !<br /><br />Après examen, manque de chance : la procédure n'en était pas une et, surtout, elle était <b>difficilement décelable</b> par l'opérateur.<br /><br />En effet, bien cachée dans une note de bas de page, en fin de section "<i>Catégorie d'huile de graissage pour le canon SnowDamm</i>", on déniche l'information :</span><br />
<br />
<blockquote class="tr_bq">
<span style="font-family: "courier new" , "courier" , monospace;">"NOTE : </span><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-family: "courier new" , "courier" , monospace;">Une optimisation de la phase de graissage pour le disque XYZ-23 est obtenue en débranchant la machine après avoir enclenché le mode "REVERSE"</span></span></blockquote>
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">Rien sur <i>"Assurer la maintenance des disques</i>" ou <i>"Effectuer le graissage des disques</i>".</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiQtevbzRxxEY2oeDYDgId_IhiVXPrQYbS5XR-l28rmiBsN0hpbW0I9mISaOLYPNOl0PoiCuda4Pzl4QWFVALXeAVRXMenyc74mSYy_o0Op4rE1nXhyphenhyphenGv1lqBxplVd5lJzTW9b04jRqy6E/s1600/searchenginewatch2-791297.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="206" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiQtevbzRxxEY2oeDYDgId_IhiVXPrQYbS5XR-l28rmiBsN0hpbW0I9mISaOLYPNOl0PoiCuda4Pzl4QWFVALXeAVRXMenyc74mSYy_o0Op4rE1nXhyphenhyphenGv1lqBxplVd5lJzTW9b04jRqy6E/s1600/searchenginewatch2-791297.jpg" width="320" /></a></div>
<br />
<br />
<h3>
<span style="font-size: x-large; font-weight: normal;"><span style="color: #990000;"><span style="font-family: "trebuchet ms" , sans-serif;">Quels sont les risques à ce stade ?</span></span></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">Importants...! En effet, au moment du procès, l'entreprise devra répondre aux questions "<i>qu'avez-vous fait pour éviter l'accident ?</i>" ou "<i>Donnez-nous la procédure précisant les conditions d'un graissage sécurisé </i>?"<br /><br />Et là, la note mal torchée et bien cachée </span><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-family: "trebuchet ms" , sans-serif;">ne suffit pas </span>!</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"> </span><br />
<h3>
<span style="font-weight: normal;"><span style="color: #990000; font-size: x-large;"><span style="font-family: "trebuchet ms" , sans-serif;">La juriste et la doc</span></span></span></h3>
<h3>
<span style="font-family: "trebuchet ms" , sans-serif;"></span></h3>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh64fuqnEYBaot5905fAOgF9OeAaHL40KYE_4aRBfWAEhcMHw8G1-AwmBR-QswhtYz9K97K2H_4ZPiOPlJI1Sf5_bTPYAi5_9SvcNamjKjJkMy9ov1kREe1LfCgHaZQlHuhR9RK_y4yAcs/s1600/Juriste.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh64fuqnEYBaot5905fAOgF9OeAaHL40KYE_4aRBfWAEhcMHw8G1-AwmBR-QswhtYz9K97K2H_4ZPiOPlJI1Sf5_bTPYAi5_9SvcNamjKjJkMy9ov1kREe1LfCgHaZQlHuhR9RK_y4yAcs/s1600/Juriste.jpg" /></a></div>
<span style="font-family: "trebuchet ms" , sans-serif;">En effet, Laura, jeune juriste très efficace, attire notre attention sur cet arrêt de la Cour d'Appel de Versailles, du 20 mai 2005, faisant intervenir l'UFC-Que Choisir et la Sté Totalgaz. La Cour a <a href="http://www.clauses-abusives.fr/juris/cav050520_277f.htm">jugé <b>abusive</b> la clause</a> par laquelle l'utilisateur reconnaissait avoir reçu communication des </span><span style="font-family: "trebuchet ms" , sans-serif;">notices de sécurité, non seulement en raison de son impression en <b><span style="color: #660000;">caractères peu lisibles, </span></b>mais aussi de <b><span style="color: #660000;">son emplacement, au milieu des conditions générales</span></b>. </span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br /></span>
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;">Et là, la jurisprudence tranche : l'info est bien là, mais difficilement accessible, donc inefficace et inutile, c'est-à-dire inexistante.</span><br />
<br />
<br />
<br />
<h3>
<span style="font-size: x-large; font-weight: normal;"><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;">Fictive cette histoire ? ...</span> </span></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">Que nenni ! Regardez cet extrait du rapport </span><span style="font-family: "trebuchet ms" , sans-serif;">de <a href="http://fr.wikipedia.org/wiki/Accident_ferroviaire_de_Br%C3%A9tigny-sur-Orge">l'accident ferroviaire de Brétigny</a>. Le Bureau Enquete Accidents, BEA, a demandé à la SNCF de <b><span style="color: #660000;">clarifier -dans la documentation- les règles de maintenance des éléments boulonnés, parce que :</span></b></span><br />
<blockquote class="tr_bq">
<i><span style="font-family: "trebuchet ms" , sans-serif;">"Pour trouver la norme de serrage qu'applique la SNCF à un boulon, il nous a fallu éplucher des dizaines et des dizaines de pages" </span></i><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span></blockquote>
<span style="font-family: "trebuchet ms" , sans-serif;">Ainsi donc, il y aurait un lien entre un accident grave et des difficultés à trouver l'information dans la documentation. Délicat, n'est-il pas ?</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"> </span><br />
<h3>
<span style="color: #660000; font-size: x-large;"><span style="font-weight: normal;"><span style="font-family: "trebuchet ms" , sans-serif;">Recherche infructueuse, cible manquée</span></span></span><br /><span style="font-weight: normal;"></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;">In fine, rappelons-nous les propos de notre éminent confrère Michael Priesley (un des grands noms dans l'implémentation DITA) : "<i>On-site search engines fail 70% of the time". </i><br /><br />De même, dans un article de la revue "Best Practices" de juin 2014, Dr. JoAnn Hackos </span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: "trebuchet ms" , sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiFq_lIzv8ho-7-icaYH-OFqeBOY-avMyQ7-c5VJLoSCFScWyMSWFtnYzzSUpvbVM-tRHuVu-VLXDoTIZj91EerRTeIu76SsyKpnCokc1jSKlgETEylM5xsJlK75KHg8OO1J8QjzDaNXTo/s1600/search_small_ForInfo.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiFq_lIzv8ho-7-icaYH-OFqeBOY-avMyQ7-c5VJLoSCFScWyMSWFtnYzzSUpvbVM-tRHuVu-VLXDoTIZj91EerRTeIu76SsyKpnCokc1jSKlgETEylM5xsJlK75KHg8OO1J8QjzDaNXTo/s1600/search_small_ForInfo.jpg" /></a></span></div>
<span style="font-family: "trebuchet ms" , sans-serif;">indique "<i>43 percent... said that they have so many overlapping versions of their content that customers cannot find the information they are looking for</i>"</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">Ce qui signifie que, dans 43 % des cas, les rédacteurs ont manqué leur cible. P</span><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-family: "trebuchet ms" , sans-serif;">our les utilisateurs, l</span>'information fournie n'existe pas ...</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">On essaie d'y remédier ?</span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-82320879343842572142015-01-28T16:22:00.000+01:002015-03-27T15:19:31.316+01:00Comment (bien) démarrer un projet de documentation ?<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjyxTUrejvtlAFUmgpNzww7yCD4gHlvtybb-oVCfUc_J0-Ah-IIan0lx_xJx2wRp-RxEfCexhouDUEpTUE2j7JeY8h6j-tKNrp3vLaVnFZ056VF6roorvA1sVkEcz3yw8bHs1NsmwPRv_U/s1600/L-angoisse-de-la-page-blanche.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjyxTUrejvtlAFUmgpNzww7yCD4gHlvtybb-oVCfUc_J0-Ah-IIan0lx_xJx2wRp-RxEfCexhouDUEpTUE2j7JeY8h6j-tKNrp3vLaVnFZ056VF6roorvA1sVkEcz3yw8bHs1NsmwPRv_U/s1600/L-angoisse-de-la-page-blanche.jpg" height="290" width="400" /></a></div>
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Que vous optiez pour une documentation minimaliste ou plus simplement structurée, il vous faut DE-MA-RRER !<br /><br />S'asseoir devant une page blanche ou copier/coller le vieux manuel de 2001, n'est PAS la bonne solution !</span><br />
<br />
<br />
<br />
<br />
<span style="color: #274e13;"><span style="font-size: x-large;"><b>_________________________________________</b></span></span><br />
<span style="color: #274e13;"><span style="font-size: x-large;"><b><span style="font-family: "Trebuchet MS",sans-serif;">De la méthode & de la norme (ISO 26 514)!</span></b></span></span><br />
<span style="color: #274e13;"><span style="font-size: x-large;"><b><span style="font-family: "Trebuchet MS",sans-serif;"> </span> </b></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">Pour envisager des processus plus efficaces et économiques, <a href="mailto:flacke@orange.fr">contactez-nous </a>! Nous pourrons organiser une présentation dans vos locaux ou dans un lieu à convenir ensemble.</span><br />
<div style="text-align: left;">
<br /></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><span style="font-size: small;"><a href="http://www.bretagne.fr/internet/jcms/preprod_60821/la-maison-de-la-bretagne"></a></span><a href="https://www.google.fr/maps/place/BioM%C3%A9rieux/@48.0705108,-1.7851087,12z/data=!4m2!3m1!1s0x0:0xf17fd72a34848a03"></a></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /><br />On y parlera </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiEBnxcO7XFN0X2YhFC7hrbU9Dv7vVCP9AcUid-PaxfC6Ud8JC7KMmS4eWI2Sv8n0QGGVQNudRISx-NGC6lF7K0TCCWKxYqbPVTCHb88pAtKCqLf_zm9gmOJkLPT-AhR4CCoTAHvIrIQ4Y/s1600/good-procedure-writing-1-728.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiEBnxcO7XFN0X2YhFC7hrbU9Dv7vVCP9AcUid-PaxfC6Ud8JC7KMmS4eWI2Sv8n0QGGVQNudRISx-NGC6lF7K0TCCWKxYqbPVTCHb88pAtKCqLf_zm9gmOJkLPT-AhR4CCoTAHvIrIQ4Y/s1600/good-procedure-writing-1-728.jpg" height="240" width="320" /></a></div>
<br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">définition des besoins, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">utilisabilité, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">profil utilisateur, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">récapitulatif des tâches, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">modélisation de procédure, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">feuille de route du rédacteur, </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">etc.</span></li>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /> </span><br />
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="color: #274e13;"><span style="font-size: x-large;"><b>________________________________________</b></span></span><br />
<b><span style="color: #274e13;"><span style="font-size: x-large;"><span style="font-family: "Trebuchet MS",sans-serif;">Bien démarrer en 2015 ?</span></span></span></b><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;">Un Guide rédactionnel ne vous dit rien ? Une procédure orientée tâches ne vous intéresse pas ?... Une Short Description vous laisse indifférent ?</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">N'hésitez pas à nous en parler <a href="mailto:flacke@orange.fr">: un message électronique</a> suffit ;-)<br /><br /><span id="goog_1128669088"></span><span id="goog_1128669089"></span> </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh5GnfxSzJ5YcPX9WIqxM1pGG1OM-aUnzVLYE9pLpMGM-0Nr_3OLjO4SWeda9Y1zsTidbtTWibHskjRTOEHwKh5VNKPinZnJAZem9w8G7NDRA2doZzMW8jqWXk6IwK4MiKkYblh0ToJsZ4/s1600/2015-Direction.jpeg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh5GnfxSzJ5YcPX9WIqxM1pGG1OM-aUnzVLYE9pLpMGM-0Nr_3OLjO4SWeda9Y1zsTidbtTWibHskjRTOEHwKh5VNKPinZnJAZem9w8G7NDRA2doZzMW8jqWXk6IwK4MiKkYblh0ToJsZ4/s1600/2015-Direction.jpeg" height="213" width="320" /></a></div>
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Comment bien démarrer 2015 ? </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">C'est démarrer avec les bonnes méthodes !</span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-71718941427430341622014-11-22T22:15:00.000+01:002015-01-12T10:42:10.253+01:00Cachez cette Short Description que je ne saurais voir !...<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><span style="color: #274e13;">Eliminons et nettoyons</span> <span style="font-size: small;">e</span></span>st le mot d'ordre de nombreux rédacteurs sur le point de migrer leur documentation vers la <a href="http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture">norme DITA</a>.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;">C'est ainsi qu'à la conférence <a href="http://www.infomanagementcenter.com/DITAeurope/2014/index.htm">DITA Europe 2014 à Munich </a>une participante expliquait que, pour réduire le volume de leur documentation, ses clients désireux de passer au minimalisme... commençaient par éliminer la <a href="http://dita.xml.org/sites/dita.xml.org/files/art_of_the_short_description.pdf">"Short Description"</a> (un des éléments essentiels du standard DITA)</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #990000;"><span style="font-size: large;">SACRILEGE !</span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #990000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="font-size: x-large;"><span style="color: #38761d;">_____________________________________</span></span></b></span> </span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #990000;"><span style="font-size: large;"> </span></span> </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjRwC61ObCzFy8-irYagY_1aXDpH1geLrpuyj2kWQXo5qbh4urki36wDvmtOcaXoIohfJyGCVyZomCA15DTLcs2i7R_LKqChRVYzNkqHVggryGSqvL8LL1K33IRvZZtoRklL863XcHdoQ0/s1600/BestPractices_Carey.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjRwC61ObCzFy8-irYagY_1aXDpH1geLrpuyj2kWQXo5qbh4urki36wDvmtOcaXoIohfJyGCVyZomCA15DTLcs2i7R_LKqChRVYzNkqHVggryGSqvL8LL1K33IRvZZtoRklL863XcHdoQ0/s1600/BestPractices_Carey.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">En effet, selon les experts Michelle Carey (co-auteur du guide "DITA Best Practices) et<a href="http://www.oxygenxml.com/dita/styleguide/webhelp-feedback/Artefact/Syntax_and_Markup/c_Guidelines_for_Crafting_Short_Descriptions.html"> Kristen Eberlein</a>, la "short description" est la partie incontournable d'un bon document procédural. Après le titre de la procédure, il faut OBLIGATOIREMENT une "Short Description".</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Dans la <ShortDesc> on expliquera le POURQUOI de la tâche incluse dans la procédure. Il s'agit de préciser à l'utilisateur quel est l'intérêt pour lui de suivre ces étapes. Il décide ensuite s'il veut poursuivre la lecture et si cela correspond à son besoin d'information.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br />Tony Self, auteur du DITA Style Guide, détaille tout cela dans son article <a href="http://blogs.adobe.com/techcomm/2013/06/reflections-on-writing-short-descriptions.html">"Reflections on Writing Short Description".</a></span><br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Par ailleurs, au moment de la recherche sur le Web, avez-vous remarqué que, sous le titre </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEizEw4XRzsENgIf-0TB5wWJJs18zazUj9oK_mB66vTiiucHegFwG7P817O2I4Vezjmapi5l4H8Gd7LekvAYCO3dW8toVNbx4Ml5f7iD1-8AuBl6ZshRDF_vrA3gHOyBR97tJnap1o5ISTw/s1600/D-Estree.gif" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEizEw4XRzsENgIf-0TB5wWJJs18zazUj9oK_mB66vTiiucHegFwG7P817O2I4Vezjmapi5l4H8Gd7LekvAYCO3dW8toVNbx4Ml5f7iD1-8AuBl6ZshRDF_vrA3gHOyBR97tJnap1o5ISTw/s1600/D-Estree.gif" height="268" width="320" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">de la procédure qui s'affiche, apparait un petit paragraphe, qui, s'il est bien ciselé, présente le condensé de la procédure ? Et bien oui, c'est la "Short Description" ! ...</span><span style="font-family: "Trebuchet MS",sans-serif;">alors, ne la cachons pas ! </span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Ne jouons pas au <a href="http://fr.wikipedia.org/wiki/Le_Tartuffe_ou_l%27Imposteur">Tartuffe </a>s'écriant "<i>Cachez ce sein que je ne saurais voir" ...</i></span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Montrez-nous la "Short Description" !<i> </i></span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgGGWJ16MfsYoLFos94aXODjLdjIyhnMOrJ6D3daAWgizDV5VYtdiFUXve9ZJasJbfDuau8OinuoWnNOKeBidZyfDb9H67tZ0SuR8eQJoV3ATldnFnl1DnRuP52bx1XKFWsYdYAJKtdaic/s1600/RechercheManuel.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgGGWJ16MfsYoLFos94aXODjLdjIyhnMOrJ6D3daAWgizDV5VYtdiFUXve9ZJasJbfDuau8OinuoWnNOKeBidZyfDb9H67tZ0SuR8eQJoV3ATldnFnl1DnRuP52bx1XKFWsYdYAJKtdaic/s1600/RechercheManuel.jpg" /></a></div>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span>Résumons : si la "Short Description" affiche l'intérêt que représente pour l'utilisateur la procédure annoncée (par le titre), ce n'est certainement pas cela qu'il faut éliminer lorsque l'on cherche à réduire la masse de documentation. Au contraire. C'est cette partie qui va indiquer à l'utilisateur si cette rubrique correspond à ce qu'il cherche... <br /><br />Le mot est tombé : "CHERCHER" (et surtout trouver...). L'utilisateur ouvre le manuel pour chercher une info précise. Comment l'aider à trouver cette info ? En lui fournissant :</span><br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">une <span style="color: #660000;"><b>table des matières</b></span> précise, bien découpée, basée sur des titres parlants (honnissons les "Introductions", "Généralités", "A propos de..."), </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">un <span style="color: #660000;"><b>index</b> </span>bien pensé </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">et une </span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="color: #274e13;"><span style="color: #660000;">Short Description</span> </span></b></span>pour voir immédiatement la "s<a href="http://fr.wiktionary.org/wiki/substantifique_moelle">ubstantifique moelle</a>" de la procédure qu'il s'apprête à lire.</span></li>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;"><br />Ce n'est donc pas cela que le rédacteur formé au minimalisme va supprimer, au contraire. En réalité, il s'agit d'une excellente mise en application du <b><span style="color: #660000;">4e principe du minimalisme </span></b>: (l'utilisateur) "<a href="http://users.edte.utwente.nl/meij/supportvarioususes.htm">read to locate some information</a>" selon Dr. Hans van der Meij. Pour la trouver, l'utilisateur dispose du titre, mais aussi de la Short Description.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #990000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="font-size: x-large;"><span style="color: #38761d;">_____________________________________</span></span></b></span></span></span></span> </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br />Si vous ne souhaitez pas embourber votre équipe de documentation dans le fatras du </span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: "Trebuchet MS",sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjxlxGJpDJiP6Dida1g3ooosyXERLRFXnEmeVxWejWeADnLo2KsXOX9BkapPPSTsp8srpK8L6whEWzr1JUcVh9uEPsWEHnJ2u37X_fhyCQpNqn9GPfVXbis5MR9haXIejNyuRlW1evJdd8/s1600/Logo_NMJServices.png" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><br /></a></span></div>
<span style="font-family: "Trebuchet MS",sans-serif;">(mauvais) minimalisme (*), jetez un oeil sur le <a href="http://comtech-serv.com/index.php?main_page=index&cPath=28_1_146_152">programme d'un atelier </a>de formation "Créer l'information dont on a vraiment besoin". </span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<br />
_____________________________<br />
<i>(*) <span style="font-family: "Trebuchet MS",sans-serif;">tout le monde en parle, mais personne n'a pris la peine de vérifier...</span></i>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-90276820728136304842014-10-26T12:14:00.000+01:002015-01-12T10:41:03.044+01:00Utiliser mon DIF pour un atelier "Documentation minimaliste" ?<div class="separator" style="clear: both; text-align: center;">
</div>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"> ... Non, mais et puis quoi encore ?</span></h4>
<h4>
<span style="color: #660000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span></span><span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span></h4>
<h4>
<span style="color: #660000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;">Quel contenu</span></span></span> <span style="color: #660000;"><span style="font-size: large;">?</span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">D'abord, que contient un <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_152">atelier "minimalisme et documentation"</a> et où <a href="http://minimalist-doc.blogspot.de/2014/09/whats-in-minimalism-workshop.html">trouver un exemple de ré-écriture</a> en version "minimaliste"</span></li>
</ul>
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Au cours de l'atelier, vous vous familiarisez avec les 4 principes du minimalisme, puis vous les mettez en application à partir de VOTRE documentation. Vous pouvez repartir avec vos propres documents retravaillés !</span></li>
</ul>
</blockquote>
<ul>
</ul>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span><br />
<ul>
</ul>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"> <span style="color: #660000;"><span style="font-size: large;">Quels destinataires ?</span></span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Mais un atelier, est-ce <a href="http://minimalist-doc.blogspot.de/2014/06/minimalist-documentation-is-this.html">vraiment pour nous </a>? </span></li>
</ul>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">L'atelier est destiné à tout rédacteur/manager vraiment désireux de fournir (enfin !) l'information utile (... et peut-être cesser d'être la risée des utilisateurs qui n'aiment pas qu'on les prenne pour des handicapés du bulbe !) </span></li>
</ul>
</blockquote>
</blockquote>
<ul>
</ul>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span><br />
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"></span></span></h4>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;">Quelle difficulté ?</span></span></span></h4>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiBGnNiqMy4467QBSqsV23YQNCa7qscZf3WDQEk0-NyN3YEWpz_4kLN1U7us2ySYY-QQe3wZpywGMB8LmIWzp0BUBryyntPQCMJi3EETXq1vCjFSkERIge5xqkKjYMYZxjEuFFzCKtXFH0/s1600/incomprehension.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiBGnNiqMy4467QBSqsV23YQNCa7qscZf3WDQEk0-NyN3YEWpz_4kLN1U7us2ySYY-QQe3wZpywGMB8LmIWzp0BUBryyntPQCMJi3EETXq1vCjFSkERIge5xqkKjYMYZxjEuFFzCKtXFH0/s1600/incomprehension.jpg" height="200" width="166" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span id="goog_342677711"></span><span id="goog_342677712"></span>Le minimalisme est difficile à comprendre et <a href="http://minimalist-doc.blogspot.de/2014/06/minimalisme-principe-n-2-loutil-integre.html">mettre en application. </a></span></li>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;">Par exemple, que couvre le principe numéro 2 ("<a href="http://users.edte.utwente.nl/meij/anchoring.htm">Anchor the tool in the task domain") ?</a></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Le minimalisme a été développé par des professionnels de l'analyse du comportement des utilisateurs. En atelier, nous clarifions et mettons en application le résultat de cette analyse.</span></li>
</ul>
</blockquote>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span> <br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<br />
<ul>
</ul>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"> Quelle finalité ?</span></span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Le minimalisme <a href="http://minimalist-doc.blogspot.de/2014/05/minimalisme-pas-chez-nous.html">contre l'infobésité : qu'y a-t-il de vrai là-dedans ?</a></span></li>
</ul>
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"> Que penser de ces collègues spécialisés dans la documentation disponible "<a href="http://www.tceurope.org/images/stories/downloads/aveiro2012/Flacke_PresentationTC_Europe1604_2100.pdf">Any time, Anywhere, On any device</a>" ? Pas question, dans ce cas, de fournir 28 pages d'avertissements à <a href="http://martarauch.wordpress.com/2014/05/16/wearable-technology-and-google-glass-why-it-matters/">lire sur des Goggle Glass </a>!</span></li>
</ul>
</blockquote>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span> <br />
<ul>
</ul>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"> Que rejeter ?</span></span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Il est question de décimer les <a href="http://minimalist-doc.blogspot.de/2014/03/jeter-aux-orties-les-vues-densemble-et.htm">"Introductions" et "Vues d'ensemble".</a>.. </span></li>
</ul>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjzVOLAUoKhtEMVd849AFcT0H9MXqdJuhZEbSUDEswoLRGNqGvQLM4nN-6hVvn99pNDZqb6DF81H9ERzC2yI3vpAxnC9qMc1CYRwYxMaxQqwOQ2Ut7GF-h9jD7SEjnGH7_BWwxWcf7naVg/s1600/reduire_superflu.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjzVOLAUoKhtEMVd849AFcT0H9MXqdJuhZEbSUDEswoLRGNqGvQLM4nN-6hVvn99pNDZqb6DF81H9ERzC2yI3vpAxnC9qMc1CYRwYxMaxQqwOQ2Ut7GF-h9jD7SEjnGH7_BWwxWcf7naVg/s1600/reduire_superflu.jpg" height="320" width="216" /></a></div>
<br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">Eliminer ? Ciel ! Est-ce vraiment <span id="goog_342677713"></span><span id="goog_342677714"></span>nécessaire ?</span></blockquote>
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">L'utilisateur n'a pas besoin de trouver, dans un manuel, ce qu'il sait déjà : que sa tondeuse sert à couper le gazon et qu'une lame bien acérée peut couper un doigt de pied !</span> </li>
</ul>
</blockquote>
<br />
<br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Un Ch'ti est-il vraiment capable de démontrer la pertinence du minimalisme ? </span></li>
</ul>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="font-family: "Trebuchet MS",sans-serif;">OUI ! Dany Boon l'a fait !... et ce n'est pas à la<a href="https://www.youtube.com/watch?v=XKg3QZGy-Ks&feature=youtu.be"> gloire du rédacteur</a> ;-)</span></li>
</ul>
</blockquote>
</blockquote>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span> <br />
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<ul>
</ul>
</blockquote>
</blockquote>
<ul>
</ul>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"> Où s'informer ?</span></span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="font-family: "Trebuchet MS",sans-serif;">Le <a href="http://minimalist-doc.blogspot.de/2013/07/l-atelier-minimalisme-et-documentation.html">minimalisme a sa FAQ</a></span><span style="font-family: "Trebuchet MS",sans-serif;"> et je voudrais bien la voir, sa foire (aux questions) !</span></li>
</ul>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Si une information vous manque, n'hésitez pas à contacter [flacke [at] orange.fr] </span></li>
</ul>
</blockquote>
</blockquote>
</blockquote>
<span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span> <br />
<ul>
</ul>
<ul>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<br />
<ul>
</ul>
<ul>
</ul>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"> Quels coûts ?</span></span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Le <a href="http://minimalist-doc.blogspot.de/2012/07/infobesite-combien-ca-coute.html">coût de l'infobésité</a> et le coût de VOTRE documentation : </span></li>
</ul>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjtGTboIj5tQUvkhwrz0RxLxZx_E4Pkmx5NY4x_tv4yqI0pxEB-hSDxCcoWYLn-SutARwnnhgF4nq4YJg8wTlZXhe-6NiOGy1lCvCmVoo73w7xU8jHJ5DHk0P5LRMo2rTwGDw_rlj0OfkU/s1600/cout_formation.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjtGTboIj5tQUvkhwrz0RxLxZx_E4Pkmx5NY4x_tv4yqI0pxEB-hSDxCcoWYLn-SutARwnnhgF4nq4YJg8wTlZXhe-6NiOGy1lCvCmVoo73w7xU8jHJ5DHk0P5LRMo2rTwGDw_rlj0OfkU/s1600/cout_formation.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">95 heures de travail perdues par employé et par an...</span></span><br />
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Avez-vous pris le temps d'estimer le <a href="http://www.indoition.com/en/services/costs-prices-software-documentation.htm">coût de votre documentation ?</a> Vous pouvez démarrer avec ces critères. </span></span></li>
</ul>
</blockquote>
</blockquote>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">En parlant de coûts, comment assurer un</span></span><span style="font-family: "Trebuchet MS",sans-serif;">e prise en charge </span><span style="font-family: "Trebuchet MS",sans-serif;">des</span> <span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://minimalist-doc.blogspot.de/2012/05/minimalisme-formation-dif.html">coûts de formation par le </a></span><span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://minimalist-doc.blogspot.de/2012/05/minimalisme-formation-dif.html"><span style="font-family: "Trebuchet MS",sans-serif;">DIF?</span></a></span></li>
</ul>
<span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="font-size: x-large;"><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">_______________________________________</span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<ul>
</ul>
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;"> Quels commentaires ?</span></span></h4>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">Oui, mais, qu'en pensent les participants ?</span></li>
</ul>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEht0tlSFXizltjGpWjTleVnEHwMScMHn6yssJE0Yw7b9xQrDyqfvPKbBOq8IGUNOHsIPudwF5N-rdknYieKyp59TMm9YwDPoFFTXueX9Td8v6vqjH4hs9O1tRnseYJpIXBI6hoTaAAR_NE/s1600/Minimalism_Workshop_Feedback.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEht0tlSFXizltjGpWjTleVnEHwMScMHn6yssJE0Yw7b9xQrDyqfvPKbBOq8IGUNOHsIPudwF5N-rdknYieKyp59TMm9YwDPoFFTXueX9Td8v6vqjH4hs9O1tRnseYJpIXBI6hoTaAAR_NE/s1600/Minimalism_Workshop_Feedback.jpg" height="80" width="400" /></a></div>
<br />
<br />
<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgbEXnI6JPi7_fN-17NiWmEMDvLEoEqOoU89jTv1xt2dY1KSQs-rxKFdxZ9zqUS5r0cZNIePiDyPUDJ9_v5PDRvzTrtJy5ozwwnuo5WfjX7ubVIaoeHFewa17gVgEDC_z4sQAEYCQ44gS8/s1600/WorkshopVelizy.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgbEXnI6JPi7_fN-17NiWmEMDvLEoEqOoU89jTv1xt2dY1KSQs-rxKFdxZ9zqUS5r0cZNIePiDyPUDJ9_v5PDRvzTrtJy5ozwwnuo5WfjX7ubVIaoeHFewa17gVgEDC_z4sQAEYCQ44gS8/s1600/WorkshopVelizy.jpg" height="127" width="400" /></a></div>
<br />Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-76242554277228505852014-10-06T09:23:00.000+02:002015-01-12T10:29:34.878+01:00Minimalism vs. Information Mapping: what's the best choice ?<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"><span style="color: #660000;"><span style="font-size: large;">Back to the sources</span></span></span></span></h4>
<span style="font-family: "Trebuchet MS",sans-serif;">In </span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://www.techwr-l.com/archives/0804/techwhirl-0804-00195.html#.VCfBE1JO5hE">an article dated April 2008</a>, </span>Bob Doyle provides a quasi-exhaustive recap about <br /> the different methods of document design.</span><span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://www.infomap.com/"><span style="font-family: "Trebuchet MS",sans-serif;"></span></a><span style="font-family: "Trebuchet MS",sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjb1WXxxMoB8kS_0HEEzooU_ImebPQWfwoGO5rttQYam4-qUyJCtAW1DE3pCwHgSL7EYPWXNt-Pgww71IVU4bHtXei28hONyWRc2YiBPDS2cOajJL9QSuuHCJiNUSmTY7cg1bLvQpvHm0w/s1600/Infomap+-+example+1.jpg" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjb1WXxxMoB8kS_0HEEzooU_ImebPQWfwoGO5rttQYam4-qUyJCtAW1DE3pCwHgSL7EYPWXNt-Pgww71IVU4bHtXei28hONyWRc2YiBPDS2cOajJL9QSuuHCJiNUSmTY7cg1bLvQpvHm0w/s1600/Infomap+-+example+1.jpg" height="207" width="320" /></a></span> </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">Information Mapping (R) was developed in mid-60's by Robert Horn who identified 7 common"Information types" of a structured document:</span><br />
<br />
<ul>
</ul>
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">classification, concept, principle, procedure, process, structure, and fact.</span></span></li>
</ul>
<ul>
</ul>
<br />
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span></span></span></span><br />
<h4>
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Structured authoring</span></span></span></span></span></h4>
<span style="font-family: "Trebuchet MS",sans-serif;">Information Mapping is considered the birth of Structured Writing as Mike West explains in "<a href="http://www.mbwest.com/MBW%20pages/Rants-structured.htm">Structured writing, structured documentation</a>".</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Information Mapping is a set of tools: </span><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"><i>"Structured documentation is a way of planning and implementing the various phases of a writing project; and we may think of structured writing as a set of tools and techniques to be used by writers during the writing phase of a project"</i></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;">If Information Mapping is the toolbox, what is<a href="http://users.edte.utwente.nl/meij/minimalism.htm"> minimalism?</a></span><br />
<br />
<h4>
<span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;">Minimalism ?</span></span></span></h4>
<span style="font-weight: normal;"><span style="font-family: "Trebuchet MS",sans-serif;">Information Mapping(R) was designed to help engineers document their programming work (reports, descriptions, etc.). Let's say it's a writing
guidance for non technical writers. Its structure is pretty rigid and
not really designed for task-oriented activities; it is more a classification of information.</span></span><br />
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;"><span style="font-size: large;"></span></span></span></h4>
<span style="font-family: "Trebuchet MS",sans-serif;">Minimalism was developed in the late '80s by John M. Carroll, member of an IBM team:</span><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">"<i>It was task orientation carried to an extreme. Minimalism meant small non-linear chunks readable in any order. It emphasized reading To Do, not reading To Know or To Learn, a phrase first introduced by Ginny Redish</i>"</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><br />Minimalism puts the END_USER in the center of the information development, not the writer. It focuses on the user's tasks. The minimalist writer ignores writing tools, GUI or product description. His first questions are always: </span><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">"<i>Who is the end-user? What does he want to achieve with this product?</i>"</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<br />
<h4>
<span style="font-weight: normal;"><span style="color: #990000;"><span style="font-size: large;"><span style="font-family: "Trebuchet MS",sans-serif;">Outdated?</span></span></span></span></h4>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h4>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgViNx7WULIaitZ5xYKLEPNLM1knoYVJLxYz-8-NAsodxM4zR2tU-f9DFaE5WghR-6kphoyicpOgGZk1eytOSBY5dCtQzOzWf8Nsl7FZb31zSyuUhKbDhPWTHOk5UIGZmzHtYBKwzgfhsA/s1600/Dr_JoAnnHackos.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgViNx7WULIaitZ5xYKLEPNLM1knoYVJLxYz-8-NAsodxM4zR2tU-f9DFaE5WghR-6kphoyicpOgGZk1eytOSBY5dCtQzOzWf8Nsl7FZb31zSyuUhKbDhPWTHOk5UIGZmzHtYBKwzgfhsA/s1600/Dr_JoAnnHackos.jpg" height="166" width="200" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://www.infomanagementcenter.com/Resources/eNews2012-12JHackos.pdf">Dr. JoAnn Hackos</a>, expert both in Information Mapping (IM) and minimalism, published an interesting research article showing that </span><br />
<blockquote class="tr_bq">
<i><span style="font-family: "Trebuchet MS",sans-serif;">"IM formatting makes absolutely no difference in user performance. It adds unnecessary words like the stem sentences: </span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://dita.xml.org/node/1410">"Do we need all that glue?</a>"</span></span></i></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;">and considers "<i>Information Mapping is outdated</i>".</span><br />
<br />
<h2>
<span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif;">What is GLUE?</span></span></h2>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h3>
<blockquote class="tr_bq">
<blockquote class="tr_bq">
<i><span style="font-family: "Trebuchet MS",sans-serif;">"Glue text is defined as <b>transitional information</b> intended to inform readers of what has come before or comes after a particular procedure, description, or explanation. </span></i><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><i>In topic-oriented authoring, which forms the basis for the DITA Model, <b>transitional text has become problematic.</b></i><b>" </b>(Dr. JoAnn Hackos)<b><br /></b></span></blockquote>
</blockquote>
<br />
<h2>
<span style="font-size: large;"><span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif;">So what ?</span></span></span></h2>
<br />
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: black;">Talking of modular, <a href="http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture">DITA-ready documentation</a>, professional technical writers don't need to think about facts, principles, structure, etc. <i> </i>In 2014, they focus on providing user-centered, useful and responsive documentation. The new challenges are <b>findability</b> and <b>usability</b> on <b>Any device, anytime, anywhere... </b>Do you really need a 4-paragraph Introduction on your<a href="http://en.wikipedia.org/wiki/Google_Glass"> Google Glass?</a></span></span></span><br />
<br />
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: black;"><i><br /></i></span></span></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-9483929186297080212014-09-12T12:03:00.001+02:002015-01-12T10:28:58.462+01:00What's in a minimalism workshop?<br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;">What are you going to learn in a minimalist workshop?</span></span></h3>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h3>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiL-knNJcNgGdJ8rGY-jhpbvaFHDve-M7neHPknAYEB4TQLdFBFJealsjZoBndBRW1rvGSQOuRV4vosnNMDFRzrgMS5cdhntRo3j9GQPeCrDw9uRToTWlkfZq6k4SGoi1jKLpexpad8bA0/s1600/computing_courtesy_jmzale.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiL-knNJcNgGdJ8rGY-jhpbvaFHDve-M7neHPknAYEB4TQLdFBFJealsjZoBndBRW1rvGSQOuRV4vosnNMDFRzrgMS5cdhntRo3j9GQPeCrDw9uRToTWlkfZq6k4SGoi1jKLpexpad8bA0/s1600/computing_courtesy_jmzale.jpg" height="212" width="320" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">No, you won't cut words and you'll go on writing complete, grammatically correct sentences.<br /><br />You'll learn how to provide the necessary information to your users... and, above all, you'll learn how to respect your users.<br /><br />Too often, information developers forget the essential: their user has </span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">already </span>a lot of knowledge and experience and this should be respected.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span><br />
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;">Example</span> </span></h4>
<span style="font-size: x-small;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">(excerpt from <a href="http://www.tcworld.info/e-magazine/technical-communication/article/a-clear-statement/">TC World magazine) </a></span></span></span><br />
<blockquote class="tr_bq">
<span style="color: #444444;"><span style="color: #660000;"><b><span style="font-family: "Trebuchet MS",sans-serif;">1. What is a user account?</span><br /><span style="font-family: "Trebuchet MS",sans-serif;">2. Set up a user account</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"> 2.1 What is a set-up assistant?</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"> 2.2 Create new user</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"> 2.3 This is how it works: New user</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"></span><br /><span style="font-family: "Trebuchet MS",sans-serif;">3. What is account management</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"> 3.1 Configure control elements</span><br /><span style="font-family: "Trebuchet MS",sans-serif;"> 3.2 This is how it works: Customize account management </span></b></span><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span><span style="font-family: "Trebuchet MS",sans-serif;"><br /></span></blockquote>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;"><b><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span> </b></span></span></h3>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;"><b>Analysis</b></span></span></h3>
<h3>
<b><span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;"></span><span style="font-family: "Trebuchet MS",sans-serif;">CONSISTENCY</span></span></b></h3>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h4>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">The title format is disturbing because not consistent.This mix of instruction-like ("<i>Set-up a user account</i>") titles with questions, combined with statements ("<i>This is how is works.</i>..") is a challenge for the end-user.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"></span><span style="font-family: "Trebuchet MS",sans-serif;">Questions are usually grouped in a FAQ and descriptions ("<i>This is how it works...</i>") belong in a tutorial, while instructions are the basics of any user guide </span><span style="font-family: "Trebuchet MS",sans-serif;">(Installation Guide, Operator's guide, Maintenance manual, etc.)</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="color: #274e13;">CONTENT</span></b></span></h3>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h4>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">The content is also quite surprising. </span></blockquote>
<br />
<blockquote class="tr_bq">
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjSALrbOkQmoHez6G8W6pzzB1iTy61IywRXMtYahFr2qTMqxvsMierTxddp988EZwOub0Tnuqnph4KJJqQYQeIjgsdxSiYi0U6NHqQSxTORqTuys256FVUyVoWPNjnujwfl3l8gZGnG240/s1600/keep_calm_and_love_a_database_administrator.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjSALrbOkQmoHez6G8W6pzzB1iTy61IywRXMtYahFr2qTMqxvsMierTxddp988EZwOub0Tnuqnph4KJJqQYQeIjgsdxSiYi0U6NHqQSxTORqTuys256FVUyVoWPNjnujwfl3l8gZGnG240/s1600/keep_calm_and_love_a_database_administrator.jpg" height="200" width="200" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">Differentiating between "<i>Set up a user accoun</i>t" and "<i>Create new use</i>r" (*) needs some clarification. Where is the difference? </span><span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">The "minimalist writer" considers: "<i>When Charles, the database administrator, receives a request for a new user, how does he call the task: 'Setting up a user account' or 'Creating a new user'?</i></span></blockquote>
<blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">Based on that, the writer starts drafting the instructions while maintaining a consistent terminology. Synonyms should be banned from any user documentation! They disturb the user : "Why another term? Why another phrase? Do they refer to different actions?" </span></blockquote>
<blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<h3>
<span style="color: #274e13;"><span style="font-family: "Trebuchet MS",sans-serif;">STRUCTURE</span></span></h3>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">Interesting is also point 3.2. </span><span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">It aims at providing conceptual information (<i>"this is how it works</i>"...), but provides _instructions_: "<i>Customize account management</i>". The title format is similar to point 2.2 : <i>"Create new user</i>".</span><span style="font-family: "Trebuchet MS",sans-serif;"> Another example of inconsistency. If it's a procedure, give it a procedural-type title (based on an action-verb).</span></blockquote>
<blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><span style="font-family: "Trebuchet MS",sans-serif;">Usually, users are not interested in knowing how it works. They want to perform a task to reach their goal. That's all!</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="color: #274e13;">USER (Respecting your users)</span></b> </span></h3>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h4>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">More significant here: the documentation designer forgot an essential point. </span></blockquote>
<br />
<blockquote class="tr_bq">
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh1Jmc0bE1FcfNL9NSGp4pbdm6LlgUM-vGg3drzu6a114W1MbEd3T-k2k5vQwpLcQA7mF_t_cA-pxa3AugQvtpalkonaio-3TLUCJnWho9JWcWLy32KEdDqlSSUY4ZSEkvx0khKI9Cj7tg/s1600/baby-and-computer.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh1Jmc0bE1FcfNL9NSGp4pbdm6LlgUM-vGg3drzu6a114W1MbEd3T-k2k5vQwpLcQA7mF_t_cA-pxa3AugQvtpalkonaio-3TLUCJnWho9JWcWLy32KEdDqlSSUY4ZSEkvx0khKI9Cj7tg/s1600/baby-and-computer.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">The user is not stupid, he is not a 6-year old in charge of managing user accounts. This is a professional with at least 3 or 4 years of experience in user account management. </span> </blockquote>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">As a technical author, do you feel like explaining this IT professional what a user account is?...</span></blockquote>
<br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">In the documentation process, technical communication professionals put the user first : they define the user's profile, his previous knowledge, his work environment, etc. It's the best way to respect the user and it's the best way to be respected as technical writer!</span></blockquote>
<blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span></span></span><br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #660000;"><b>Proposed (minimalist) solution </b></span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<blockquote class="tr_bq">
<b><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">1. Setting up a user account</span></span></b><br />
<blockquote class="tr_bq">
<b><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">1.1 Setting up a user account from the XXX page</span></span><br /><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">1.2 Setting up a user account with the set-up assistant</span></span></b></blockquote>
<b><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"></span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;"></span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">2. Managing a user account</span></span></b><br />
<blockquote class="tr_bq">
<b><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">2.1 Configuring control elements</span></span><br /><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: #274e13;">2.2 Customizing the account management</span></span></b></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span></span></span></span><br />
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b> </b></span></span></span></span>DITA-compliant?</span></span></h3>
<h4>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h4>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiRd8DqQ2o766XmrfNnOedkNFZQuCygfzkYCSFlTO6J1Fn89GhsI9b5huaw7sNp9nVQSBRhSZSclKwFP4tuaf5QM-qNMce4xvMQ_WzzmkmZh0DId9YUOy5RsGnOQHx-4pla7iWNOzuESkk/s1600/Preschool-Computing.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiRd8DqQ2o766XmrfNnOedkNFZQuCygfzkYCSFlTO6J1Fn89GhsI9b5huaw7sNp9nVQSBRhSZSclKwFP4tuaf5QM-qNMce4xvMQ_WzzmkmZh0DId9YUOy5RsGnOQHx-4pla7iWNOzuESkk/s1600/Preschool-Computing.jpg" /></a></div>
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Desperate situation: following the original model, it is obvious the documentation won't be<a href="http://dita.xml.org/"> DITA-ready.<span id="goog_890507272"></span><span id="goog_890507273"></span></a> It is going to be a costly and painful migration to sort (and re-write) the content in tasks, concepts and references...</span><br />
<br />
<br />
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span></span></span></span> <br />
<h4>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">More information on Minimalism workshops</span></span></h4>
<ul>
<li><span style="font-size: small;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: black;">Workshops are available<a href="http://tinyurl.com/pxbo833"> in the US and in Europe</a>. </span></span></span></span></li>
<li><span style="font-size: small;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: black;">Your organization can hold an <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_145">in-house workshop.(Reduced rates)</a></span></span></span></span></li>
<li><span style="font-size: small;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="color: black;">If financing your participation to a workshop is an issue, link your <a href="http://youtu.be/XNRTrT2GIEU">management to this discussion</a> or this <a href="http://youtu.be/zIz6-svkabI">one (in German)</a>. </span></span></span></span></li>
</ul>
<br />
<br />
_______________________________________<br />
(*) <span style="font-family: "Trebuchet MS",sans-serif;">wondering wether it's possible to create an old user account...</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-38093905017583043382014-08-28T21:22:00.000+02:002016-03-07T09:55:43.722+01:00Section "Troubleshooting" ...Comment faire ? <span style="font-family: "trebuchet ms" , sans-serif;">Un chapitre "Troubleshooting" dans ma documentation ? Reprise sur erreur avez-vous dit ?...</span><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjgq7fHI2oGS7k-S2JXTyEOeeWBN_Aiy_lHywX5ZFQphB_RE4xwHsIZu3obIoiCTqvBXZdRPOFtjyUeylEtDhTBwjDTWM9p_cFQpY5O0Nb8cTDS1A8Fbxt0B52JH1p3hZzfrfGZ0BX4V2A/s1600/kaput-913x1024_Gizmophiliacs.png" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjgq7fHI2oGS7k-S2JXTyEOeeWBN_Aiy_lHywX5ZFQphB_RE4xwHsIZu3obIoiCTqvBXZdRPOFtjyUeylEtDhTBwjDTWM9p_cFQpY5O0Nb8cTDS1A8Fbxt0B52JH1p3hZzfrfGZ0BX4V2A/s1600/kaput-913x1024_Gizmophiliacs.png" width="178" /></a></div>
<span style="font-family: "trebuchet ms" , sans-serif;">C'est le principe n° 3 du minimalisme : </span>"<span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-family: "trebuchet ms" , sans-serif;"><a href="http://users.edte.utwente.nl/meij/supporterrorhandling.htm">Support error recognition and recovery". </a></span>Il s'agit d'aider l'utilisateur à retomber sur ses pieds, alors qu'il a fait une erreur.</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><span style="font-family: "trebuchet ms" , sans-serif;">Pour faciliter le retour sur la bonne voie, le rédacteur a deux options:</span><span style="font-family: "trebuchet ms" , sans-serif;"> </span><br />
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;"> donner la résolution du problème exactement là où a pu se déclencher l'erreur, c'est-à-dire dans la procédure,</span></li>
</ul>
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-family: "trebuchet ms" , sans-serif;">créer une section "Résoudre les problèmes"</span></span><span style="font-family: "trebuchet ms" , sans-serif;">. </span></li>
</ul>
<span style="font-family: "trebuchet ms" , sans-serif;">Intervenir directement dans la procédure répond exactement à la recommandation de <a href="http://users.edte.utwente.nl/meij/minimalism.htm">Dr. van der Meij</a></span><a href="http://users.edte.utwente.nl/meij/minimalism.htm"> :<span style="font-family: "trebuchet ms" , sans-serif;"> </span></a><br />
<blockquote class="tr_bq">
<span style="font-family: "trebuchet ms" , sans-serif;">"<i>Provide error information when actions are error-prone or when correction is difficult"</i></span></blockquote>
<span style="font-family: "trebuchet ms" , sans-serif;">Ce principe de la correction d'erreur est complété par <a href="http://www.infomanagementcenter.com/enewsletter/2008/200801/feature.htm">Dr. JoAnn Hackos</a>, (webinaire du 27.08.2014). Il s'agit d'aider les utilisateurs à détecter, définir, diagnostiquer et corriger les problèmes.</span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: "trebuchet ms" , sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgWRsYfZxYgUPv5lKs5DA0iKRRakOxUXsLbFF2i2LOLWqt-hEL0XPCCqDoSRfjwGttPALHZJPEjeBmKqMFcmHz-xfF2Kqn1_hU956ROF-PyDPFTFlsFIsKLCJ5F0Sxq2b54tvy-QVWeaa4/s1600/help_Troubleshooting_Netquake.png" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgWRsYfZxYgUPv5lKs5DA0iKRRakOxUXsLbFF2i2LOLWqt-hEL0XPCCqDoSRfjwGttPALHZJPEjeBmKqMFcmHz-xfF2Kqn1_hU956ROF-PyDPFTFlsFIsKLCJ5F0Sxq2b54tvy-QVWeaa4/s1600/help_Troubleshooting_Netquake.png" width="145" /></a></span></div>
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">L'essentiel est d'indiquer :</span><span style="font-family: "trebuchet ms" , sans-serif;"> </span><br />
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;">la <b>cause</b> du problème</span></li>
</ul>
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;">le <b>moyen de résoudre</b> le problème</span></li>
</ul>
<span style="font-family: "trebuchet ms" , sans-serif;">A ne pas négliger non plus : donner -à l'utilisateur- la possibilité de trouver rapidement le chapitre "Troubleshooting" !</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<br />
<h2>
<span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-size: x-large;">"Troubleshooting" : le modèle______ </span></span></span><span style="font-size: large;"><span style="font-family: "trebuchet ms" , sans-serif;"> </span></span></h2>
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">Le comité DITA OASIS a mis au point, dans sa version 1.3, le modèle de rubrique "Troubleshooting". Aucune raison de ne pas s'en inspirer !</span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br />En prenant l'exemple de <a href="https://www.oasis-open.org/committees/download.php/53516/DITA13TroubleshootingArticle_FINAL_03jul14.pdf">l'article du 3 juillet</a> 2014 (<a href="http://dita.xml.org/standard">Comité DITA OASIS</a>), on va repérer les éléments de ladite rubrique : <b>Title, Short Description, Condition/Situation, Cause, Remedy </b></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<h2>
<span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;"><span style="font-size: large;">Mise en pratique</span> </span></span></h2>
<h3>
<span style="font-family: "trebuchet ms" , sans-serif;"></span></h3>
<span style="font-family: "trebuchet ms" , sans-serif;"><b><span style="color: #660000;"> ________________________</span></b></span><span style="font-family: "trebuchet ms" , sans-serif;"><b><span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;"><b>ORIGINAL</b></span>____________________________</span></b><br /><i><b>Titre</b>: System will not turn on</i></span><br />
<i><span style="font-family: "trebuchet ms" , sans-serif;"><br /><b>ShortDesc</b>: Everything looks right, but the system still does not start</span></i><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj4Rb8rxvgCMaA4su8DfkXb6KyN4QBkJbPn7nOOqkdDyq19kh-OpyXpIV-z2dnGyko3IBELR4JdRW7QrYvZFfdZ8UlFOa5w4oPIlGNil99_AsvoSrRfhYHkFgaG3HmMUB1cGi3cIvbCXao/s1600/Problem_PlanA.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj4Rb8rxvgCMaA4su8DfkXb6KyN4QBkJbPn7nOOqkdDyq19kh-OpyXpIV-z2dnGyko3IBELR4JdRW7QrYvZFfdZ8UlFOa5w4oPIlGNil99_AsvoSrRfhYHkFgaG3HmMUB1cGi3cIvbCXao/s1600/Problem_PlanA.jpg" width="200" /></a></div>
<i><span style="font-family: "trebuchet ms" , sans-serif;"><br /><b>Condition/Situation</b>: The system is plugged in, the power switch is on, but the system will not start.</span></i><br />
<i><span style="font-family: "trebuchet ms" , sans-serif;"><br /><b>Cause:</b> The problem is usually due to power not being supplied to the system through the electrical outlet. Often, a circuit breaker has been tripped so that no power is available at the outlet.</span></i><br />
<br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<div class="separator" style="clear: both; text-align: center;">
</div>
<div class="separator" style="clear: both; text-align: center;">
</div>
<div class="separator" style="clear: both; text-align: center;">
</div>
<span style="font-family: "trebuchet ms" , sans-serif;"><i><b>Remedy/Solution</b>: <br /><b><span style="color: #cc0000;">WARNING </span></b><br />If you don't not know how to reset circuit breakers, do not attempt ot fix this problem. Instead, find somebody who is qualified to do this for you.<br /><br />1. Turn the system power switch to OFF<br />2. Reset the breaker<br />3. Turn the system power switch on O</i>N.<br /><br /><i>The system turns on.</i><br /><br /><b><span style="color: #660000;">_______________________</span></b></span><span style="font-family: "trebuchet ms" , sans-serif;"><b><span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;"><b>VERSION OPTIMISEE</b></span>______________________</span></b><br />On peut optimiser le contenu, tout en gardant la structure :<br /><br /><span style="color: #660000;"><b>Titre :</b> System will not start<br /><br /><b>Mini Desc : </b>If the system does not start, it is probably due to the circuit breaker. It is recommended to have a qualified professional reset the circuit breaker. <br /><br /><b>Situation : </b>The system is plugged in, the power switch is on, but the system will not start.<br /><br /><b>Cause : </b>Power is not supplied to the system through the electrical outlet. A circuit breaker has probably been tripped that blocks power distribution.</span></span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;"><b>Solution :</b><br />1. Make sure you have the necessary skills to reset the circuit breakers</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: "trebuchet ms" , sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiwupaicTTjXBJKh6FY3uY4qxQ-vYAXOoEN9i-VoL9oF41CehiyhQA6wQNkrJITbcxZMNCqEYNxUFhmdhCDGjasTcJrUBppewG-BafI5wqAqPK95JMDbSBQW3FXOdKNv3J8o6XFKub20hk/s1600/index_solution.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="200" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiwupaicTTjXBJKh6FY3uY4qxQ-vYAXOoEN9i-VoL9oF41CehiyhQA6wQNkrJITbcxZMNCqEYNxUFhmdhCDGjasTcJrUBppewG-BafI5wqAqPK95JMDbSBQW3FXOdKNv3J8o6XFKub20hk/s1600/index_solution.jpg" width="197" /></a></span></div>
<span style="color: #660000;"><span style="font-family: "trebuchet ms" , sans-serif;">2. Turn the system power switch to OFF<br />3. Reset the breaker<br />3. Turn the system power switch on ON.</span></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br /></span>
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<h3>
<b><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;">______________________</span></span></b></h3>
<h3>
<b><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;">COMMENTAIRES</span></span></b></h3>
<h3>
</h3>
<ul>
<li><span style="font-family: "trebuchet ms" , sans-serif;"> En anglais, nous avons l'élément <i>"Condition</i>" qui, IMHO, peut porter, en français, à confusion. On serait tenté par une traduction littérale et cela mènerait inévitablement à de grosses bourdes. Il ne s'agit pas de donner les conditions pour que le système ne marche pas, mais bien de clarifier la SITUATION de blocage dans laquelle l'utilisateur se trouve.</span></li>
<li><span style="font-family: "trebuchet ms" , sans-serif;"> La version originale inclut un "Warning" qui s'avère inapproprié. Il n'y a pas de danger physique (ou, tout au moins, il n'est pas indiqué), donc pas d"AVERTISSEMENT". </span></li>
</ul>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYYxmnKt8K3X4pt4vSsDkYXRrdMFphMC5OsT5b0bsSoJiZ0d-Glnr5hWgrNi7t0bmkMvH5_5vok3UbWyAWbZsy2RVBlUx2aeRToKEmFAoO9feEjpy6hWivyxZBKyspdjgq-a1I3jtJo8Q/s1600/solution_keyboard.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="146" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhYYxmnKt8K3X4pt4vSsDkYXRrdMFphMC5OsT5b0bsSoJiZ0d-Glnr5hWgrNi7t0bmkMvH5_5vok3UbWyAWbZsy2RVBlUx2aeRToKEmFAoO9feEjpy6hWivyxZBKyspdjgq-a1I3jtJo8Q/s1600/solution_keyboard.jpg" width="200" /></a></div>
<span style="font-family: "trebuchet ms" , sans-serif;">Rajouter des avertissements dans une rubrique "Troubleshooting" va mener vers le sac de noeuds dans lequel l'utilisateur ne retrouvera pas les instructions nécessaires à sa reprise sur erreur. </span><br />
<span style="font-family: "trebuchet ms" , sans-serif;">L'information contenue dans cet avertissement peut trouver sa place dans une instruction et, comme démontré ci-dessus, dans la "Short Description".</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">Chaque <b>rubrique</b> "Résolution des problèmes" s'insère fort bien dans un <b>chapitre</b> "Résoudre les problèmes" qui, avec un titre parlant, facilite la recherche.</span><br />
<br />
<span style="font-family: "trebuchet ms" , sans-serif;">L'insertion d'une mini-rubrique "Problème ?" dans la procédure, sera détaillée dans un autre article du blog... </span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<h3>
<b><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;">_____________________________________________________</span></span></b></h3>
<h3>
<b><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;">Poursuivre l'exercice ?</span></span></b></h3>
<span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;"><span style="color: black;"><span style="font-size: small;">Venez en parler lors<span style="font-family: "trebuchet ms" , sans-serif;"> de la <a href="http://www.uaconference.eu/index.html">conférence User Assistance Europe</a> qui se tiendra les 9 et 10 juin 2016 à Budapest où il sera question de... <a href="http://www.uaconference.eu/sessions.html#troubleshooting">troubleshooting </a>!</span></span></span></span></span><b><span style="font-family: "trebuchet ms" , sans-serif;"><span style="color: #660000;"></span></span></b><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"></span><br />
<span style="font-family: "trebuchet ms" , sans-serif;"><br /></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com1tag:blogger.com,1999:blog-4470063915169982637.post-34750947826699611482014-06-24T22:26:00.001+02:002015-01-12T10:27:13.697+01:00Combien d'argent ai-je jeté par les fenêtres aujourd'hui ?<span style="font-family: Trebuchet MS, sans-serif;">En matière de documentation produits, voici trois pistes pour brasser de l'air et dépenser à tour de bras :</span><br />
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">produire un Pdf de </span><a href="http://www.washingtonpost.com/blogs/wonkblog/wp/2014/05/08/the-solutions-to-all-our-problems-may-be-buried-in-pdfs-that-nobody-reads/" style="font-family: 'Trebuchet MS', sans-serif;">400 pages que personne ne lit</a></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">noircir </span><a href="http://support.rjssoftware.com/sites/default/files/documentation/RJS_Imaging_Client_User_Guide_4_4_7_1.pdf" style="font-family: 'Trebuchet MS', sans-serif;">180 pages pour décrire les fonctionnalités</a><span style="font-family: 'Trebuchet MS', sans-serif;"> du produit, en incluant 2 copies </span><span style="font-family: Trebuchet MS, sans-serif;">d'écran par page, dont plusieurs </span><span style="font-family: 'Trebuchet MS', sans-serif;">affichent le bouton OK. Ou alors préciser que l'onglet d'annotation sert à afficher le document annoté !</span></li>
</ul>
<div>
<span style="font-family: Trebuchet MS, sans-serif;">
</span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: Trebuchet MS, sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhG2cXPrvgbfu3JGtJ3R0_fMHYnpzHDWf8Q6XCHiI09m8WHt04CoQm9aJ-irP3cTzDb-szZv1aQozVqhG8disxfTZLwFk9EhjKutLSH7dXVF4NJYOoi2z_i8YOgCvch8Ob-idwO_obP-Sw/s1600/StatingTheObvious.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhG2cXPrvgbfu3JGtJ3R0_fMHYnpzHDWf8Q6XCHiI09m8WHt04CoQm9aJ-irP3cTzDb-szZv1aQozVqhG8disxfTZLwFk9EhjKutLSH7dXVF4NJYOoi2z_i8YOgCvch8Ob-idwO_obP-Sw/s1600/StatingTheObvious.jpg" height="203" width="640" /></a></span></div>
<br />
<ul></ul>
</div>
<div>
<span style="font-family: Trebuchet MS, sans-serif;"></span><br />
<br />
<br />
<br />
<br />
<br />
<br />
<li style="margin-left: 40px;"><span style="font-family: Trebuchet MS, sans-serif;">passer 4 h 45 à rédiger <a href="http://minimalist-doc.blogspot.fr/2014/03/jeter-aux-orties-les-vues-densemble-et.html">le chapitre "Généralités"</a> ... que l'utilisateur ne va pas lire.</span></li>
<br />
<b style="color: #38761d; font-size: x-large;">__________________________________________</b><br />
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large;">Suzie-la-Terreur</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Et voici Suzie-La-Terreur (terreur des équipes de rédaction) pour qui la documentation </span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: Trebuchet MS, sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj10KDShvZnwvm_kEMVt3vdp8mNOvzQFnnk0pNHd2OW2h_yxA_QpoefH5wfkuu-ZepV1iGH9E6ZNzqxxEayjvMYw2qT0E-4ex9JOzvbzYiHAv5zLwwES83Cxdd8DMgGYOGDfvf3YTCxfT4/s1600/Ruth-Jacobi--A-walk-in-New-York-street--1928-JojoLaMenace.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj10KDShvZnwvm_kEMVt3vdp8mNOvzQFnnk0pNHd2OW2h_yxA_QpoefH5wfkuu-ZepV1iGH9E6ZNzqxxEayjvMYw2qT0E-4ex9JOzvbzYiHAv5zLwwES83Cxdd8DMgGYOGDfvf3YTCxfT4/s1600/Ruth-Jacobi--A-walk-in-New-York-street--1928-JojoLaMenace.jpg" height="320" width="301" /></a></span></div>
<span style="font-family: Trebuchet MS, sans-serif;">technique, c'est comme l'oie que l'on promène dans les rues de New York : </span><span style="font-family: 'Trebuchet MS', sans-serif;">décalée, rutilante, humoristique,</span><span style="font-family: Trebuchet MS, sans-serif;"> hors contexte, futil</span><span style="font-family: 'Trebuchet MS', sans-serif;">e... risible !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br />
</span> <span style="font-family: Trebuchet MS, sans-serif;">Son manuel sur papier glacé est futile, décalé, risible et </span><span style="font-family: 'Trebuchet MS', sans-serif;">inutile</span><span style="font-family: 'Trebuchet MS', sans-serif;"> parce qu'il ne répond pas aux questions précises telle que "</span><i style="font-family: 'Trebuchet MS', sans-serif;">comment faire pour modifier les paramètres sans perdre mes enregistrements précédents" </i><span style="font-family: 'Trebuchet MS', sans-serif;">que se pose l'utilisateur<i>.</i></span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><i><br />
</i></span> <span style="font-family: 'Trebuchet MS', sans-serif;">Par contre, ledit manuel se contente de ressasser les évidences. Sous <i>Software Update</i>, il est effectivement impératif d'ajouter qu'il faut avoir installé la version précédente avant de mettre à jour !</span><i style="font-family: 'Trebuchet MS', sans-serif;"></i><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj51RKesexE7DA2j-m7o1g1i0D3owaJGjMLoCNeTOIcXeSd1DOVx-0ERjZzhJ5lLAdpLimYpwPyBIwvyYa_KqYEZ-opt8XfmOO1mHD3zmU6iHDqFRPEisq4XYnK97FbfvPbo-EDlN0Zerk/s1600/UpdatRequirements.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj51RKesexE7DA2j-m7o1g1i0D3owaJGjMLoCNeTOIcXeSd1DOVx-0ERjZzhJ5lLAdpLimYpwPyBIwvyYa_KqYEZ-opt8XfmOO1mHD3zmU6iHDqFRPEisq4XYnK97FbfvPbo-EDlN0Zerk/s1600/UpdatRequirements.jpg" height="60" width="640" /></a><i style="font-family: 'Trebuchet MS', sans-serif;"></i></div>
<br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Aucune raison de se pavaner dans les salles de réunion avec le manuel de 450 pages si l'utilisateur s'en sert comme rehausseur de siège !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br />
</span> <span style="font-family: Trebuchet MS, sans-serif;">Bien sûr, Suzie-et-son-oie-à-New-York (<i>Photo de Ruth Jacobi, 1928</i>) </span><span style="font-family: 'Trebuchet MS', sans-serif;">nous plaisent beaucoup : elles feraient un excellent fond d'écran . </span><br />
<b style="color: #38761d; font-size: x-large;">__________________________________________</b><br />
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large;">Suzie-la-dispendieuse</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Transposée dans le monde de la rédaction technique, Suzie ne génère qu'une chose : REJET ! Cette documentation est coûteuse parce qu'inexploitable : aucun utilisateur ne va y trouver rapidement </span><span style="font-family: 'Trebuchet MS', sans-serif;">la réponse à sa question. Ce faisant, Suzie a tout fait pour détruire l'image du métier et confirmer que la documentation ne sert à rien, sauf à générer des coûts inutiles !</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"> En cela, elle se rapproche du <a href="http://minimalist-doc.blogspot.fr/2014/02/le-minimalisme-explique-par-un-chti.html">rédacteur de Dany Boon</a> (celui qui explique en 5 langues comment démarrer le micro-ondes) </span><br />
<b style="color: #38761d; font-size: x-large;">___________________________________________</b><br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large; font-weight: normal;">Comment s'en sortir ? Où est l'alternative ?</span></h2>
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiyIMjcDFc2msQdTT3IgVpPW9kDLX86nepw_mq7stWNRHmL6A-7NR8y7r_VRK6Boq5B9s5KQrKb5CraBzjxaMGYcSDEAktKTgFki8PZN8Cf-nsxux5PT9WmE7APA4vUSQauGN4nwOeT36w/s1600/less_is_more.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiyIMjcDFc2msQdTT3IgVpPW9kDLX86nepw_mq7stWNRHmL6A-7NR8y7r_VRK6Boq5B9s5KQrKb5CraBzjxaMGYcSDEAktKTgFki8PZN8Cf-nsxux5PT9WmE7APA4vUSQauGN4nwOeT36w/s1600/less_is_more.jpg" height="213" width="320" /></a><span style="font-family: 'Trebuchet MS', sans-serif;">Ne donner à l'utilisateur que ce dont il a besoin !... c'est la base du "</span><span style="font-family: 'Trebuchet MS', sans-serif;">Minimalism: </span><a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_8" style="font-family: 'Trebuchet MS', sans-serif;">creating information people really need</a>"<br />
<br />
<br />
<br />
<span style="font-family: 'Trebuchet MS', sans-serif;">Il s'agit d'une formation exclusivement basée sur la _pratique_: vous apportez vos </span><br />
<span style="font-family: Trebuchet MS, sans-serif;">documents et vous repartez avec VOTRE DOCUMENTATION passée au crible du minimalisme.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br />
</span> <br />
<br /></div>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com2tag:blogger.com,1999:blog-4470063915169982637.post-4139929274953895282014-06-24T16:42:00.001+02:002015-01-12T10:43:14.374+01:00Minimalist documentation : is this workshop for you?<br />
<ul>
<li>I<span style="font-family: Trebuchet MS, sans-serif;">s your management asking you to reduce documentation costs? </span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">Do you create information that few customers use? </span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">Do you have fewer people to create and maintain the volume of information you've created in the past? </span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">Are you pursuing content management and structured writing?</span></li>
</ul>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="color: #6aa84f;"><b>_</b></span></span><b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;">_____________________________________________________________________</b><br />
<div>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large;">Attending a "minimalism" workshop </span><span style="font-family: Trebuchet MS, sans-serif;"> </span><br />
<span style="font-family: Trebuchet MS, sans-serif;">If your answers are "yes,"a minimalism workshop meets your needs directly. Minimalist documents take time and effort to design, </span><span style="font-family: 'Trebuchet MS', sans-serif;">but once you have them in place, the savings are clear. Minimalist documents <b>cost less to produce</b>, are easier to maintain, and reduce requests for customer support.</span><br />
<h2>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="color: #6aa84f;"><b>_</b></span></span><b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;">_______________________________________________________________________ </b><span style="font-weight: normal;"><span style="font-family: 'Trebuchet MS', sans-serif;"><span style="color: #660000; font-size: x-large;">Mi</span></span><span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">nimizing your production costs</span></span></h2>
<span style="font-family: Trebuchet MS, sans-serif;">Minimalism is the key to getting the maximum return on your single-sourcing investment.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgSVsbY2npTaaepcEdiKvSrodz99ViD2ZvxVGXCxUiefqU0i7GXnRkXqWnlCKK7K_3vur-_7hgnTX8i2CHTfdLzAhASnqfb4EHV4Udka80pgTNvzQ7kb_N6PeBSxJ2G79XlJTsDly0RSyg/s1600/Quality-Cost-Analysis.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgSVsbY2npTaaepcEdiKvSrodz99ViD2ZvxVGXCxUiefqU0i7GXnRkXqWnlCKK7K_3vur-_7hgnTX8i2CHTfdLzAhASnqfb4EHV4Udka80pgTNvzQ7kb_N6PeBSxJ2G79XlJTsDly0RSyg/s1600/Quality-Cost-Analysis.jpg" height="207" width="320" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">Minimalism isn't only for simple products or targeted at beginners. </span><span style="font-family: 'Trebuchet MS', sans-serif;">A minimalist approach <b>makes complex products easier to understand</b> and gets critical information more directly into the hands of experts.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">People attending this workshop report they've reduced their documentation by 50 to 75 percent.</span><br />
<h2>
<span style="color: #660000; font-weight: normal;"><span style="font-family: Trebuchet MS, sans-serif;"><br /></span></span></h2>
<h2>
<b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif; font-size: medium;">_______________________________________________________________</b><span style="color: #660000; font-weight: normal;"><span style="font-family: Trebuchet MS, sans-serif;"><br /></span><span style="font-family: Trebuchet MS, sans-serif; font-size: x-large;">Taking your documentation to the mobile world</span></span></h2>
<span style="font-family: Trebuchet MS, sans-serif;">Is your documentation <a href="http://www.tceurope.org/images/stories/downloads/aveiro2012/Flacke_PresentationTC_Europe1604_2100.pdf">going mobile</a>? Did you know that M</span><a href="http://www.nngroup.com/articles/mobile-content-is-twice-as-difficult/" style="font-family: 'Trebuchet MS', sans-serif;">obile content is twice as difficult </a>?<br />
<div>
<br /></div>
<span style="font-family: 'Trebuchet MS', sans-serif;">Minimalism is designed for your needs (or do you </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjb3Swvr0K2JCjLQw9tT-JoN43gFKWzAuQySD1jfRvIjUSHGX2cFzZ0tAbys-Gw23ecG2O-mruW75FsPTHD5UL_I40gLT8SnLkepd2Kl4YIvFraaV_7w7TkHrRdYy02YbCSjfvYYTBl5ak/s1600/Mobile.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjb3Swvr0K2JCjLQw9tT-JoN43gFKWzAuQySD1jfRvIjUSHGX2cFzZ0tAbys-Gw23ecG2O-mruW75FsPTHD5UL_I40gLT8SnLkepd2Kl4YIvFraaV_7w7TkHrRdYy02YbCSjfvYYTBl5ak/s1600/Mobile.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">want to copy-paste your PDF manual on your mobile screen?...) </span><br />
<div>
<br />
<br />
<b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;">_________________________________________</b><br />
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">Workshop: Is it really for me ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">This <a href="http://comtech-serv.com//index.php?main_page=product_info&cPath=28_1_146_8&products_id=62&zenid=bq36pdjm431j8tlmej94rhgrs7">workshop</a> offers a hands-on approach: You work on your own documents for more than 50 percent of class time. Be sure to bring a sample of past work, work-in-progress, or planned work that you want to trim. If you have a team working on reducing document size and cost, we recommend coming to the workshop together.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">You will learn to:</span><br />
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Evaluate when minimalist strategies should be used</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Know the four basic principles of minimalism</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Understand why you must motivate users</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Promote learning by doing rather than by reading</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Evaluate what to trim and why</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Focus on troubleshooting advice</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Identify opportunities to replace text with graphics</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Get maximum value from graphics</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Write, edit, and review documents for minimizing</span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"> Prioritize your efforts when resources are slim</span></li>
</ul>
<div>
<span style="font-family: Trebuchet MS, sans-serif;">After the <a href="http://comtech-serv.com//index.php?main_page=product_info&cPath=28_1_146_8&products_id=62">29-30 september 2014 in </a>Liège-Seraing, the next workshop will take place <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_152">15-16 December 2014, in Paris (in French).</a></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: 'Trebuchet MS', sans-serif;"></span></div>
<span style="font-family: 'Trebuchet MS', sans-serif;">
</span>
<br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<span style="font-family: 'Trebuchet MS', sans-serif;">
</span></div>
<div>
<br />
<span style="color: #660000;"><b style="font-family: 'Trebuchet MS',sans-serif;"><span style="font-size: small;">Too expensive this 2-day workshop?</span></b></span><br />
<span style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;"><span style="color: black;"><span style="font-size: small;">Listen to <a href="http://youtu.be/XNRTrT2GIEU">Betty discussing with her documentation manager</a> the opportunity to register for the next workshop.</span></span></span><span style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;"></span><b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;"><br /> ________________________________________________________________________</b><br />
<b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;"> </b><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">Why is </span><a href="http://www.infomanagementcenter.com/enewsletter/2008/200801/feature.htm" style="font-family: 'Trebuchet MS', sans-serif; font-size: xx-large;">minimalism so popular</a><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-large;"> today?</span></div>
<br />
<div>
<span style="font-family: Trebuchet MS, sans-serif;">People prefer that information be in the <b>context of their goals, their tasks, and their working environment</b>. If they can find information that directly tells them how to reach their goals, they are much happier than if they have to extrapolate from disparate facts. They would like to have information that presents them with realistic scenarios and shows how the goals of the scenarios are best accomplished. They prefer hints, tips, and tricks that show them the best way to get a task done.</span></div>
<br />
<br /><h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif;">________________________________________________________________________</b> </span></h3>
</div>
</div>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0Liège, Belgique50.6325574 5.5796662000000250.4713829 5.2569427000000193 50.793731900000004 5.90238970000002tag:blogger.com,1999:blog-4470063915169982637.post-3525608137082550242014-06-07T14:33:00.001+02:002014-06-07T16:07:01.259+02:00Minimalisme: principe n° 2 "L'outil intégré dans la tâche"<span style="font-family: Trebuchet MS, sans-serif;">Oui, mais, </span><span style="font-family: 'Trebuchet MS', sans-serif;">... qu'est-ce que cela veut dire au moment de la conception de la documentation ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<h2>
<span style="font-family: 'Trebuchet MS', sans-serif; font-weight: normal;"><span style="color: #660000; font-size: x-large;">Anchor the tool in the task domain</span></span></h2>
<div>
<span style="font-family: 'Trebuchet MS', sans-serif;">Disons : <i>"l</i></span><i style="font-family: 'Trebuchet MS', sans-serif;">'outil doit être considéré par rapport à la tâche"</i></div>
<div>
<span style="font-family: 'Trebuchet MS', sans-serif;">Dr.</span> <span style="font-family: Trebuchet MS, sans-serif;"><a href="http://users.edte.utwente.nl/meij/anchoring.htm">Hans van der Meij </a></span><span style="font-family: 'Trebuchet MS', sans-serif;">nous l'explique : </span></div>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"><i>For most users, an application is a tool they want to use to achieve objectives in their own task domain. </i></span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"><i>The tool is merely a means; it is almost never an end in itself. </i></span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"><i>The designer should therefore select or design instructional activities that are<b> real tasks.</b></i></span></li>
</ul>
<h3>
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif;">Les vraies tâches : comment les approcher ?</span></h3>
<div>
<span style="font-family: Trebuchet MS, sans-serif;">Il s'agit, entre autre, de prendre en compte l'utilisateur (et non pas l'outil) avec :</span></div>
<br />
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">son environnement de travail / ses </span><span style="font-family: 'Trebuchet MS', sans-serif;">conditions de travail </span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;">son savoir-faire / </span><span style="font-family: 'Trebuchet MS', sans-serif;">sa formation </span><span style="font-family: 'Trebuchet MS', sans-serif;">initiale et </span><span style="font-family: 'Trebuchet MS', sans-serif;">continue </span></li>
</ul>
<b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">________________________________________</b><span style="font-family: Trebuchet MS, sans-serif;"><br /></span><br />
<h2>
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-weight: normal;"><span style="font-size: x-large;">Sergio, le monteur</span></span></h2>
<span style="font-family: Trebuchet MS, sans-serif;">Par exemple, <a href="http://www.ffie.fr/espace-jeunes/les-metiers-de-lelectricite/energie/monteur-de-reseau-de-distribution-electrique">Sergio</a>,expert monteur de lignes électriques, aimerait beaucoup que la documentation fournie pour les nouveaux boîtiers de raccordement soit adaptée à</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">son savoir-faire existant, mais aussi à ses conditions de travail.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Pour cela, le rédacteur prend soin de fournir un plan détaillé des circuits des boîtiers, convaincu que cette illustration sera utile au monteur.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Pour que ce soit clair, il le fait imprimer au format A3, le tout bien plié dans le manuel papier au format A4. Beau travail.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Au moment de <a href="http://www.youtube.com/watch?v=sbDl3cujvJQ">grimper au poteau</a>, </span><span style="font-family: Trebuchet MS, sans-serif;">Sergio, de son côté,</span><span style="font-family: 'Trebuchet MS', sans-serif;">vérifie </span><span style="font-family: Trebuchet MS, sans-serif;">son équipement : vêtements de protection, </span><span style="font-family: 'Trebuchet MS', sans-serif;">chaussures de sécurité, casque, gants de protection, harnais, outillage et </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhITMRjF_X-yiKL16jzw95ywq8S5UhfnICzvD343dNx_PZfICSH8AZTnBeW-HlYdsovZF0MEAlk5BWVNEd7onT5dsNhExg4FwNeS8HLjJVodoPW2_6oC7i3C5GrckGbR1tZNyMGrdrQ0X0/s1600/grimpette2.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhITMRjF_X-yiKL16jzw95ywq8S5UhfnICzvD343dNx_PZfICSH8AZTnBeW-HlYdsovZF0MEAlk5BWVNEd7onT5dsNhExg4FwNeS8HLjJVodoPW2_6oC7i3C5GrckGbR1tZNyMGrdrQ0X0/s1600/grimpette2.jpg" height="181" width="320" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">"grimpettes".</span><br />
<div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><b>Question</b> : où va-t-il maintenant glisser le manuel d'installation? </span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Ingénieux, Sergio, vient de trouver une place dans une poche externe du pantalon.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Et c'est parti pour l'ascension avec grimpettes !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<b style="color: #6aa84f; font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">________________________________________</b><br />
<h2>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="color: #660000; font-size: x-large; font-weight: normal;">Le rédacteur a pensé à tout... sauf à l'essentiel</span></span></h2>
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif;"> Environnement de travail</span></h3>
<span style="font-family: Trebuchet MS, sans-serif;">En équilibre sur son poteau, Sergio veut vérifier un détail du montage du boîtier. </span><br />
<br />
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">Comment atteindre l'information pertinente si son environnement de travail </span><span style="font-family: 'Trebuchet MS', sans-serif;">joue les trouble-fêtes ? </span></li>
</ul>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">Comment déplier le schéma de montage au format A3 p</span><span style="font-family: Trebuchet MS, sans-serif;">ar grand vent, sous la pluie, ... ou parce qu'il doit impérativement porter des gants ?</span></li>
</ul>
<div>
<span style="font-family: Trebuchet MS, sans-serif;">Retour à la case départ : le manuel est inutilisable dans les véritables conditions de travail.</span></div>
<br />
<h3>
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif;">Savoir-faire : formation initiale, formation continue</span></h3>
<span style="font-family: 'Trebuchet MS', sans-serif;">Mais, fichtre, pourquoi est-ce que l'installateur ne lit pas le manuel si bien ciselé pour lui ?</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhwNGcqOhB1lFD-TZUGlD99fP1p1sT7XsYr5uglTRJNarHwdY9kJ4nYbVuN4Dyjdj-JtRgdyGZZ9JKVEPoI3oHDh5xzBuJ_mFTCcmvt2yBeO7i2VeXW82N3Lvsq72m-e-eVl00pNOrgS-E/s1600/PoseurLignesEquilibre.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhwNGcqOhB1lFD-TZUGlD99fP1p1sT7XsYr5uglTRJNarHwdY9kJ4nYbVuN4Dyjdj-JtRgdyGZZ9JKVEPoI3oHDh5xzBuJ_mFTCcmvt2yBeO7i2VeXW82N3Lvsq72m-e-eVl00pNOrgS-E/s1600/PoseurLignesEquilibre.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">Et bien tout simplement parce qu'il se base sur son savoir-faire. Ce n'est pas dans VOTRE manuel qu'il apprend le métier. C'est au moment de sa </span><span style="font-family: 'Trebuchet MS', sans-serif;">formation initiale.</span><br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Ensuite, il conforte son savoir par transmission par les "anciens". Dans le cas de Sergio, ils sont toujours deux monteurs pour une installation. </span><span style="font-family: 'Trebuchet MS', sans-serif;">La transmission de savoir se fait donc sans intermédiaire et <i>in situ</i>.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Donc, il n'est pas nécessaire de lui expliquer les dangers de l'électricité à haute tension ! Il le sait mieux que le rédacteur et depuis </span><span style="font-family: 'Trebuchet MS', sans-serif;">son premier cours !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">En formation continue, nombreuses entreprises chargés de travaux dangereux organisent des réunions régulières </span><span style="font-family: 'Trebuchet MS', sans-serif;"> avec tous les opérateurs pour analyser une ou deux procédures du manuel.</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><span style="color: #6aa84f; font-size: large;"><b>_____________________________________________________</b></span></span><br />
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: x-large;">Alors que faire ? </span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Le rédacteur doit-il tout simplement abandonner le traditionnel "Guide d'installation" </span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><b>inutilisable en situation réelle </b>?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Non, il optera plutôt pour un manuel basé sur le minimalisme en :</span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: Trebuchet MS, sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEihN0Gu-2lZ-2E_T8QWm0RJB-uo5rh6m3y5dljxY9NiVA_z0rcSinvJLmCAn7hzU_YVCWw0toWswyrAN2ba8r7yWJiUr9wuZzYfzJ1T4UJ7Yig4TRG6X7A59KRQYZpxyXjzsaFHmONQxhg/s1600/gamification.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEihN0Gu-2lZ-2E_T8QWm0RJB-uo5rh6m3y5dljxY9NiVA_z0rcSinvJLmCAn7hzU_YVCWw0toWswyrAN2ba8r7yWJiUr9wuZzYfzJ1T4UJ7Yig4TRG6X7A59KRQYZpxyXjzsaFHmONQxhg/s1600/gamification.jpg" /></a></span></div>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">prévoyant des fiches cartonnées pour les infos indispensables</span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">envisageant la migration des fiches sur support mobile </span></li>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">proposant des supports de formation continue (gamification, bandes dessinées, videos, etc.</span></li>
</ul>
<br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">... et en évitant de démarrer une section du manuel par "1ère étape - coupez le courant". Sergio le sait depuis longtemps !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">- </span></div>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com1tag:blogger.com,1999:blog-4470063915169982637.post-40175233826013992312014-05-28T16:18:00.001+02:002014-06-02T18:16:26.576+02:00Minimalism authoring: some resources<br />
<span style="font-family: Trebuchet MS, sans-serif;">“<i>The essence of the minimalist approach is <u>to obstruct as little as possible</u> the learner’s selfinitiated </i></span><span style="font-family: 'Trebuchet MS', sans-serif;"><i>efforts to find <u>meaning in the activities of learning</u>.</i>” (John M. Carroll)</span><br />
<h3>
<span style="color: #660000;"><span style="font-family: Trebuchet MS, sans-serif;"><br />
</span><span style="font-family: Trebuchet MS, sans-serif;">Basics by John M. Carroll and Hans van der Meij</span></span></h3>
<ul><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEitfj_r-DDAvOHseut33zDQw6S8iGI9MFE73yGPD5d8jhDBd5BmJu-tT3JImGFtCpoFk6pI-2f1a7CBdhCq7L0oM5JwP9n-citahknK2BxQlWoAzt0LMuQjzCrc99SYUsQA__szzesbBt8/s1600/NurnbergFunnel.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEitfj_r-DDAvOHseut33zDQw6S8iGI9MFE73yGPD5d8jhDBd5BmJu-tT3JImGFtCpoFk6pI-2f1a7CBdhCq7L0oM5JwP9n-citahknK2BxQlWoAzt0LMuQjzCrc99SYUsQA__szzesbBt8/s1600/NurnbergFunnel.jpg" height="200" width="185" /></a>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"> </span><a href="http://books.google.fr/books/about/Minimalism_Beyond_the_Nurnberg_Funnel.html?id=LvXiZJEUJjAC&redir_esc=y" style="font-family: 'Trebuchet MS', sans-serif;">Minimalism Beyond the Nurnberg Funnel</a></li>
</ul>
<ul>
<li><a href="http://users.edte.utwente.nl/meij/displaywriter.pdf" style="font-family: 'Trebuchet MS', sans-serif;">First Minimalist Manual </a></li>
</ul>
<ul>
<li><a href="http://users.edte.utwente.nl/meij/minimalism.htm" style="font-family: 'Trebuchet MS', sans-serif;">Minimalism principles</a><span style="font-family: 'Trebuchet MS', sans-serif;"> </span></li>
</ul>
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif;"><br />
</span></h3>
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif;">Applications</span></h3>
<ul>
<li><a href="http://comtech-serv.com/features/MinimalismHuman-ComputerInterfaces.pdf" style="font-family: 'Trebuchet MS', sans-serif;">An application of the Principles of Minimalism to the Design of Human-Computer Interfaces</a></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;"> </span><a href="http://www.infomanagementcenter.com/Resources/eNews2012-12JHackos.pdf" style="font-family: 'Trebuchet MS', sans-serif;">Minimalism updated 2012 </a></li>
</ul>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEitKhJZBSpK6Mxf4jgh-jT2Go492SWXIYYv2j5mZNWQfqBO0xPK6FU8j7tCQo5_MHMG5knwvHoAQ2hgM1onSKhxTE5m6A864tkRTQd3uAKS0Hufs05acpWAEE11gYJQ2ZGoP3rI1B840bQ/s1600/minimalism_web_design.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEitKhJZBSpK6Mxf4jgh-jT2Go492SWXIYYv2j5mZNWQfqBO0xPK6FU8j7tCQo5_MHMG5knwvHoAQ2hgM1onSKhxTE5m6A864tkRTQd3uAKS0Hufs05acpWAEE11gYJQ2ZGoP3rI1B840bQ/s1600/minimalism_web_design.jpg" height="256" width="320" /></a></div>
<br />
<ul>
<li> <a href="http://www.infomanagementcenter.com/enewsletter/2008/200803/second.htm" style="font-family: 'Trebuchet MS', sans-serif;">Minimalism and DITA enable significant cost savings</a><span style="font-family: 'Trebuchet MS', sans-serif;"> for Avaya Telephone manuals</span></li>
</ul>
<ul>
<li><a href="http://www.infomanagementcenter.com/enewsletter/2008/200801/feature.htm" style="font-family: 'Trebuchet MS', sans-serif;">What make minimalism so popular today?</a></li>
</ul>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"> </span><a href="http://www.infomanagementcenter.com/enewsletter/2007/200709/third.htm" style="font-family: 'Trebuchet MS', sans-serif;">Scenarios and Minimalism,</a><span style="font-family: 'Trebuchet MS', sans-serif;"> by Bill Gearhart</span></li>
</ul>
<ul>
<li><a href="http://www.infomanagementcenter.com/members/newsletter/Output/2010/04-April/04042010.php" style="font-family: 'Trebuchet MS', sans-serif;">Minimalism: a cereal killer</a></li>
</ul>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"> </span><a href="http://www.hikaripub.com/presentations/Minimalist_References.pdf" style="font-family: 'Trebuchet MS', sans-serif;">List of references</a></li>
</ul>
<div>
<br />
<br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif;">Academic research</span></h2>
</div>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"> The minimalist Approach to Online Instructional Videos, b</span><span style="font-family: Trebuchet MS, sans-serif; font-size: x-small;">y EH Pflugfelder, </span><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-small;">published in Volume 60, Number 2, May 2013 l Technical Communication</span></li>
</ul>
<ul><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhK-hp21Pu54f8aXqKcnwuuNXmC1yx74wptQWxGkcoYJdgFY4zgf2801riW3Z6cH-h95EBz7oExgaqKUc6zq1HXGFfhPAfU_E0fJmlCngOgfNn1EH67LL7umMmqfGnFjqPule-pMTBs47M/s1600/academic_Research.jpg" imageanchor="1" style="clear: right; display: inline !important; float: right; font-family: 'Trebuchet MS', sans-serif; margin-bottom: 1em; margin-left: 1em; text-align: center;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhK-hp21Pu54f8aXqKcnwuuNXmC1yx74wptQWxGkcoYJdgFY4zgf2801riW3Z6cH-h95EBz7oExgaqKUc6zq1HXGFfhPAfU_E0fJmlCngOgfNn1EH67LL7umMmqfGnFjqPule-pMTBs47M/s1600/academic_Research.jpg" /></a>
<li><span style="font-family: Trebuchet MS, sans-serif;"> <a href="http://faculty.washington.edu/farkas/dfpubs/Farkas-Williams-CarrollsNurnbergFunnel.pdf">John Carroll's The Nurnberg Funnel and Minimalist Documentation, </a></span><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-small;"> by David Farkas in IEEE Transactions on Professionnal Communication, vol.33, No 4, December 1990</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;"> <a href="http://faculty.washington.edu/farkas/dfpubs/Farkas-Williams-CarrollsNurnbergFunnel.pdf">Ten misconceptions about minimalism,</a> b</span><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-small;">y Dr. Hans van der Meij </span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">Applying Minimalist Principles, Strategies, and Techniques, </span><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-small;">by Susan M.J. Lester</span></li>
</ul>
<span style="font-family: Trebuchet MS, sans-serif;"></span><br />
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">Goal-orientation, goal setting and goal-driven behavior in (minimalist) user instructions, </span><span style="font-family: 'Trebuchet MS', sans-serif; font-size: x-small;"> by Dr. Hans van der Meij, IEEE Transactions on Professional Communications, 50 (4) 295-205</span></li>
</ul>
<span style="font-family: Trebuchet MS, sans-serif;"><br />
</span> <br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif;">Complementary reading</span></h2>
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;"> <a href="http://www.infomanagementcenter.com/members/newsletter/Output/2011/12-December/12012011.php">Content Curation: Building bridges between web writing and DITA Authoring</a></span></li>
</ul>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjUuEoZlLiFopibqeLxiuy8e6RJtpbFYT16GOFao97bfYA8epgq6qG2y_TnV8iQtMYwL_3vHOquZ1CuBQEvo-jFteoUpVW-v2ny9SH0o6W2G-8ZhzAvNcgBT9u9b6qb0iVFMSAtjlu1iHs/s1600/UnStructuredDoc.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjUuEoZlLiFopibqeLxiuy8e6RJtpbFYT16GOFao97bfYA8epgq6qG2y_TnV8iQtMYwL_3vHOquZ1CuBQEvo-jFteoUpVW-v2ny9SH0o6W2G-8ZhzAvNcgBT9u9b6qb0iVFMSAtjlu1iHs/s1600/UnStructuredDoc.jpg" height="129" width="320" /></a></div>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;"><a href="http://www.infomanagementcenter.com/enewsletter/2007/200703/feature.htm">User scenarios - A Center Point for User Learning</a></span></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"><a href="http://www.infomanagementcenter.com/members/pdfs/reprints/BP06-00GRedish.pdf">Structured authoring </a></span></li>
<li><a href="http://www.cs.utep.edu/novick/papers/why.sigdoc06.pdf" style="font-family: 'Trebuchet MS', sans-serif;">Why Don't People read the manual?</a></li>
<li><span style="font-family: Trebuchet MS, sans-serif;"><a href="http://www.youtube.com/watch?v=1EGU4wpcAXo">Why users don't read that f... manual? (video)</a></span></li>
</ul>
<h3>
<b><span style="color: #660000; font-family: Trebuchet MS, sans-serif;">Se former aux techniques du minimalisme </span></b></h3>
<span style="font-family: Trebuchet MS, sans-serif;">Le prochain atelier "documentation minimaliste" aura lieu <a href="http://comtech-serv.com//index.php?main_page=product_info&cPath=28_1_144&products_id=62&zenid=30jg96onpcdkfm7kgd00g4bn70">les 29 et 30 septembre 2014 à Liège</a>. Qu'on se le dise ;-)</span><br />
<br />
<br />Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-85568224457335082072014-05-26T16:57:00.000+02:002015-06-18T08:02:54.358+02:00La documentation minimaliste ?... un mauvais plan !<h2>
<span style="color: #990000; font-family: Trebuchet MS, sans-serif;">La documentation dite minimaliste ne m'intéresse pas parce que :</span></h2>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">je n'y connais rien</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">ça n'a pas été inventé chez nous</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">c'est du mauvais travail. Il faut TOUT dire à l'utilisateur</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">mon boss ADORE les gros manuels. Je suis payé à la page...</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">le département de documentation n'a pas de problèmes de budget</span></li>
</ul>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj0s33FTG6IhvgXJBkR8SujR6RVym5TOug_1qTWNB6_FVsJXE5aUFkmL07gC-tdSAsIHsnijNEBN6OiUxnZSIYgg_dtxC9MgcrK0CTBGlqlJqJ-g3PMK2KkxybOWde-RqxnMX5E7qKgEtw/s1600/Dilbert_Budget.gif" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img alt="" border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj0s33FTG6IhvgXJBkR8SujR6RVym5TOug_1qTWNB6_FVsJXE5aUFkmL07gC-tdSAsIHsnijNEBN6OiUxnZSIYgg_dtxC9MgcrK0CTBGlqlJqJ-g3PMK2KkxybOWde-RqxnMX5E7qKgEtw/s1600/Dilbert_Budget.gif" title="" /></a><span style="font-family: Trebuchet MS, sans-serif;"></span></div>
<span style="font-family: Trebuchet MS, sans-serif;">
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
</span><br />
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">les utilisateurs ? Je m'en fiche ! Ils n'ont qu'à lire le manuel de A à Z</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">il est hors de question de changer de méthode de rédaction. On a toujours fait comme ça</span></li>
</ul>
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">vous parlez DITA ? <div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgOfeKm17_JAcYu3i028p0sYNLxya6pDmOlsKubmEEqwy-RwIGCRizy5Z7EJLK8iVmv2gUhqSZ9h3wjuznzmDVg76pFAwRApF4OBf6sZ7Iv5xC7Z_-t3_lHninAs-KiVsQ1KoAf_OuiKEU/s1600/DITA.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgOfeKm17_JAcYu3i028p0sYNLxya6pDmOlsKubmEEqwy-RwIGCRizy5Z7EJLK8iVmv2gUhqSZ9h3wjuznzmDVg76pFAwRApF4OBf6sZ7Iv5xC7Z_-t3_lHninAs-KiVsQ1KoAf_OuiKEU/s1600/DITA.jpg" /></a></div>
Publication sur tablette ? Responsive design...? Foutaises ! Il n'y a qu'une seule doc, c'est la documentation papier !</span></li>
</ul>
<div class="separator" style="clear: both; font-family: 'Trebuchet MS', sans-serif; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhKF1XV18vBcH8TOgLUyuV5dzmpNcF9WR71LnU87P1x3gNlN94YVMDcusKv9JNeZd5veSiAQEpkG8KLqNxYAcG_eBkW82iDbcHW4ShiNocbJFrf4zULfzrallf3sGy3MM13d_h4JuMYphw/s1600/Twitter%252Blaptop.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" height="178" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhKF1XV18vBcH8TOgLUyuV5dzmpNcF9WR71LnU87P1x3gNlN94YVMDcusKv9JNeZd5veSiAQEpkG8KLqNxYAcG_eBkW82iDbcHW4ShiNocbJFrf4zULfzrallf3sGy3MM13d_h4JuMYphw/s1600/Twitter%252Blaptop.jpg" width="200" /></a></div>
<br />
<ul>
<li><span style="font-family: Trebuchet MS, sans-serif;">vous voulez mixer Twitter </span><span style="font-family: 'Trebuchet MS', sans-serif;">et la documentation technique ?... </span><span style="font-family: 'Trebuchet MS', sans-serif;">Profonde aberration ! </span></li>
</ul>
<br />
<span style="font-family: 'Trebuchet MS', sans-serif;">On ne se la joue pas "Première Dame", chez nous !</span><br />
<br />
<br />
<br />
<br />
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhn-AGDpecTAjp4_R5jCN0R_PVbyalVMELfFYsYMgsFupuexO_4PwgwrS8w-CdLKWXe8BhJgy5SFFTdG-Luet7j9334O844MkGGfG_IGVRcVMgnjj2WkbXcJPDauO52boe_5bSzrPqyIvA/s1600/error-message_stupid.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" height="274" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhn-AGDpecTAjp4_R5jCN0R_PVbyalVMELfFYsYMgsFupuexO_4PwgwrS8w-CdLKWXe8BhJgy5SFFTdG-Luet7j9334O844MkGGfG_IGVRcVMgnjj2WkbXcJPDauO52boe_5bSzrPqyIvA/s1600/error-message_stupid.jpg" width="400" /></a><br />
<div style="text-align: right;">
<div style="text-align: left;">
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<br />
<ul>
<li><span style="font-family: 'Trebuchet MS', sans-serif;">l'overdose d'avertissements et de notes vous gène ? </span></li>
</ul>
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<br />
<div style="text-align: left;">
<span style="font-family: 'Trebuchet MS', sans-serif;">C'est inévitable, parce que </span><span style="font-family: 'Trebuchet MS', sans-serif;">l'utilisateur est un crétin !</span></div>
</div>
</div>
<div style="text-align: left;">
<span style="font-family: 'Trebuchet MS', sans-serif;">Il faut tout lui répéter !</span></div>
<div style="text-align: right;">
<br /></div>
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span><span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<br />
<br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Pour plus d'information sur le montage d'un atelier "minimaliste", contactez [flacke@orange.fr]</span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-113168496636456002014-05-21T20:20:00.001+02:002014-08-02T21:00:02.295+02:00Minimalisme ? pas chez nous !<span style="font-family: Trebuchet MS, sans-serif;">"Nous fournissons un travail sérieux, nous ! Nous ne rechignons pas devant l'ampleur de la tâche : nous fournissons la totalité de l'information ! Un travail vraiment complet... sinon rien !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Le minimalisme est réservé aux rédacteurs à mi-temps, ceux qui veulent un travail "quick and dirty" !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large; font-weight: normal;">Alors, vous préférez l'infobésité ? </span></h2>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjeKy4LpWdbupHy7HnTyXTgfAJ6RSc3tzy253SveqpOn2AMr9vSIu_tDkgqlvjWzow4HzRkY9XbAR3RYOfCvevOjnwHcL-0cIN95TYwpDV9JPWDrN4yQOJwRzJdrPLuTk3GFncq_7Q2IKY/s1600/the-problem-of-infobesity-512x250.png" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjeKy4LpWdbupHy7HnTyXTgfAJ6RSc3tzy253SveqpOn2AMr9vSIu_tDkgqlvjWzow4HzRkY9XbAR3RYOfCvevOjnwHcL-0cIN95TYwpDV9JPWDrN4yQOJwRzJdrPLuTk3GFncq_7Q2IKY/s1600/the-problem-of-infobesity-512x250.png" height="156" width="320" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">...disons u</span><span style="font-family: 'Trebuchet MS', sans-serif;">n <a href="http://www.dennews.com/news/student-publishes--page-apple-ii-computer-manual/article_5a929868-2c7f-11e2-9e69-001a4bcf6878.html">beau manuel de 800 page</a>s ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Mais vous, cher rédacteur, quand avez-vous ouvert et utilisé un manuel de 800 pages ?</span><br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Rappelez-vous l'excellent sketch de Dany Boon qui tente de lire -en première mondiale- un <a href="http://minimalist-doc.blogspot.fr/2014/02/le-minimalisme-explique-par-un-chti.html">manuel utilisateur en entier </a>...</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"></span><br />
<br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large; font-weight: normal;">Complète votre documentation ?</span></h2>
<span style="font-family: 'Trebuchet MS', sans-serif;"> ... mais est-elle utile ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Effectivement, 400 pages seulement pour votre guide opérateur paraissent bien digestes. C'est bien ! Mais savez-vous comment votre utilisateur va chercher (et trouver) l'information qu'il recherche ? </span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Avez-vous remarqué que Nokia produit la totalité de sa documentation selon les 4 principes du minimalisme ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">...à votre avis, vos utilisateurs ne méritent pas <a href="http://download.support.nokia.com/ncss/PUBLIC/en_GB/webpdf/100000336184/Nokia_Lumia_1520_UG_en_GB.pdf">la qualité Nokia</a> ?</span><br />
<br />
<h2>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: x-large; font-weight: normal;"> Secteur réglementé</span></h2>
<span style="font-family: Trebuchet MS, sans-serif;">Vous rejetez le minimalisme p</span><span style="font-family: 'Trebuchet MS', sans-serif;">arce que vous intervenez <a href="http://minimalist-doc.blogspot.fr/2013/09/documentation-minimaliste-pas-dans-le.html">dans le nucléaire</a> ? dans <a href="http://minimalist-doc.blogspot.fr/2013/10/documentation-medicalelinfobesity-ca-se.html">le médical</a> ? dans<a href="http://minimalist-doc.blogspot.fr/2013/10/aeronautique-documentation-minimaliste.html"> l'aéronautique </a>? ... Vous souvenez-vous QUI vous a démontré que les règles du minimalisme étaient incompatibles avec votre secteur ?</span><br />
<a href="http://www.eventbrite.fr/e/inscription-minimalisme-non-pas-pour-moi-11481570687" style="clear: right; display: inline !important; float: right; font-family: 'Trebuchet MS', sans-serif; margin-bottom: 1em; margin-left: 1em; text-align: center;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEh1EcTP9OO0UY6Rb9AfmK3ezONlwqy3cBaSQvIQj7AG1EyxMSLu296m7kSdCeu7QZscNGueDw0NiwdAihgNxYsbVdSOqsSBwHtb1o9mItqLAeZoHJnhTR50cDWI37qea_FtpoBKVZ5CaXE/s1600/stcfrance-logo.png" /></a><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Branchez-vous sur l'enregistrement du </span><span style="font-family: 'Trebuchet MS', sans-serif;"></span><a href="https://stc.adobeconnect.com/_a1021687493/p8rvqm3692z/?launcher=false&fcsContent=true&pbMode=normal" style="font-family: 'Trebuchet MS', sans-serif;">webinaire organisé par la STC France</a><span style="font-family: 'Trebuchet MS', sans-serif;"> le </span><b style="font-family: 'Trebuchet MS', sans-serif;">mardi 27 mai 2014 ! </b><span style="font-family: 'Trebuchet MS', sans-serif;">Vous aurez la présentation et les échanges.</span><br />
<br />
<h3>
<span style="font-weight: normal;"><span style="color: #660000; font-size: large;"><span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span><span style="font-family: 'Trebuchet MS', sans-serif;">Formation par atelier interactif</span></span></span></h3>
<span style="font-weight: normal;"><span style="font-family: 'Trebuchet MS', sans-serif;">Le prochain atelier aura lieu <a href="http://comtech-serv.com//index.php?main_page=product_info&cPath=28_1_144&products_id=62&zenid=30jg96onpcdkfm7kgd00g4bn70">les 29 et 30 septembre 2014 à Liège</a> (BE)</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<br />
<br />Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-46112589356818019902014-05-03T00:04:00.000+02:002014-07-06T10:30:00.136+02:00Grammaire, conjugaison, phraséologie... Quel ennui !<div class="separator" style="clear: both; text-align: center;">
</div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Dans un raccourci fulgurant, certains rédacteurs pensent qu'en implémentant les<a href="http://www.infomanagementcenter.com/Resources/eNews2012-12JHackos.pdf"> règles du minimalisme</a>, ils peuvent passer rapidement sur ces scories que sont les règles de<br />grammaire, de conjugaison et autre horreurs comme l'orthographe.</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhW6By_fd1ySlV5-Elexyy9Ue2qLhv_O1AUL75Z5e5Q2bUY2Oduj9iEaOjMEIL9u6g_aD4ePpo444tY5KDyJrHOlYoHOS4e_rxhEBR48tbriBvUzGHAh3ZefqWMz9eAmAX-znJ3vv_3Dno/s1600/grammaire.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhW6By_fd1ySlV5-Elexyy9Ue2qLhv_O1AUL75Z5e5Q2bUY2Oduj9iEaOjMEIL9u6g_aD4ePpo444tY5KDyJrHOlYoHOS4e_rxhEBR48tbriBvUzGHAh3ZefqWMz9eAmAX-znJ3vv_3Dno/s1600/grammaire.jpg" /></a></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br />Puisque le minimalisme cherche à éliminer le superflu, éliminons les <a href="http://fr.wikipedia.org/wiki/Pluriel_des_noms_communs_fran%C3%A7ais_en_%C2%AB_ou_%C2%BB">rigidités grammaticales !</a></span></span><br />
<br />
<b><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span><span style="font-size: large;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">La conjugaison ? quelle abomination !</span></span></span></b><br />
<h3>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span></h3>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Et pourtant, parmi les principes de base de la rédaction "minimaliste", on trouve : <b>"Rédiger au présent" (jamais au futur)</b>. </span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">En effet, l'utilisateur veut savoir ce qui va se passer s'il appuie sur ce bouton vert MAINTENANT, pas dans 30 minutes. </span></span><br />
<ul>
<li><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><i>Appuyez sur CRTL+ALT+XXX</i></span></span><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><i> L'enregistrement démarre.</i></span></span> </li>
</ul>
(et non pas "<i>L'enregistrement va démarrer"</i> ou "<i>L'enregistrement démarrera</i>")<br /><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br />Dans une <a href="http://fr.slideshare.net/sharonvburton/customer-experiencewebinar">présentation disponible en lign</a>e, notre collègue Sharon B. recommande, dans sa diapo n° 25, de rédiger à la voix active et au temps présent.<br /><br />Dans sa colonne de droite, elle indique donc "Present tense" et donne des exemples dont :</span></span><br />
<div style="text-align: left;">
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"> "<i>Your email is automatically sent the next time a network is found</i>"</span></span></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br /></span></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgThco0DtAvyPi3D-hDzjAeWLDMeTA2amITS533oRhA08PPAi57WHB079unt_FwKOBPojOp5Fi9TqQUTIRBnurz1UwLZWi8jRm7lFNF8E7KQnMiL-SzwROZD9zSAmtwy8Jg8BVOWstA-58/s1600/Concorde.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgThco0DtAvyPi3D-hDzjAeWLDMeTA2amITS533oRhA08PPAi57WHB079unt_FwKOBPojOp5Fi9TqQUTIRBnurz1UwLZWi8jRm7lFNF8E7KQnMiL-SzwROZD9zSAmtwy8Jg8BVOWstA-58/s1600/Concorde.jpg" /></a></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">... oui, un abysse s'ouvre devant nous !</span></span></span></span><br />
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Si cette phrase est au présent (et accessoirement à la voix active), je veux bien être condamnée à nettoyer la place de la Concorde à la brosse à dents ! </span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgAIUfCnrT15Pgg6CjMGTmP0dOLLMKUKTPXdDw_M1HEE4v4hf2vZBsvFb3f-5CsYUBcA5J2LIo190TOL53QkGyJvPHikZ4JvtZ7uojAfC1n5lNNF8SqC01K8E1LNaza-rJoqqDPr7zVQWQ/s1600/brosseAdents.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgAIUfCnrT15Pgg6CjMGTmP0dOLLMKUKTPXdDw_M1HEE4v4hf2vZBsvFb3f-5CsYUBcA5J2LIo190TOL53QkGyJvPHikZ4JvtZ7uojAfC1n5lNNF8SqC01K8E1LNaza-rJoqqDPr7zVQWQ/s1600/brosseAdents.jpg" height="200" width="200" /></a></span></div>
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Dans les temps antédiluviens, on faisait la différence entre le présent et le passé composé :</span></span> "<i>Votre e-mail est envoyé automatiquement dès que le système trouve un réseau</i>" (passé composé)</span></span><br />
-et-<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">"<i>Le logiciel envoie votre e-mail</i>" c'est du présent (et de la voie active).</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br />Pour les <a href="http://conjugaison.lemonde.fr/conjugaison/">hésitations en conjugaison</a>, voici de quoi vous rattraper aux branches...</span></span><br />
<h2>
<span style="font-size: large;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">Voix passive ...quelle dérive !</span></span></span></h2>
<h3>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span></h3>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Tous nos grands maîtres en documentation technique s'accordent pour nous recommander : <b>"N'écrivez jamais à la voix passive</b>". Tout simplement parce qu'on ne sait jamais, dans ce cas, QUI fait l'action.</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
</div>
<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg_FlCJcLoYuSaaTf7gOZ-TTEt6fIPl7QkLXvEtUtqgneAGy8GwFrwNwsHKeIIo2IjQMOnF-dOg99vHlj2pyzaTT9yCvQQx4IwVA8_NIlnFd1dO8kuq6j0cuy7nmiSnkPG8f_6AaPeLUug/s1600/musaraigne.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg_FlCJcLoYuSaaTf7gOZ-TTEt6fIPl7QkLXvEtUtqgneAGy8GwFrwNwsHKeIIo2IjQMOnF-dOg99vHlj2pyzaTT9yCvQQx4IwVA8_NIlnFd1dO8kuq6j0cuy7nmiSnkPG8f_6AaPeLUug/s1600/musaraigne.jpg" height="109" width="200" /></a></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Comme par exemple : <br /><i>"Le logiciel est démarré en appuyant sur le bouton</i>" -ou- "<i>L'alarme est neutralisée après le déclenchement du levier vert".</i><br /><br />D'accord, mais qui appuie sur le bouton ? le perroquet ? la musaraigne qui passait par là ? ou alors est-ce que le logiciel est programmé pour déclencher un appui sur le bouton ?<br /><br />De mauvaises langues rapportent que, lorsque certains rédacteurs tournent leurs <a href="http://www.salle34.net/la-voix-active-et-la-voix-passive/">phrases au passif</a>, c'est parce qu'ils n'ont pas compris le fonctionnement du système (et ne veulent pas trop se fatiguer à chercher)... des mauvaises langues, je vous le dis ! </span></span><span style="font-size: large;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span></span><br />
<h2>
</h2>
<h2>
<b><span style="font-size: large;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">En minimalisme, une seule voix : la VOIX ACTIVE !</span></span></span></b></h2>
<h2>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span></h2>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><i> Dès que vous appuyez sur le bouton XXX, le logiciel démarre</i></span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Malheureusement, notre collègue californienne n'a pas été touchée par la grâce de la voix active (vu qu'elle ne fait pas la différence entre les deux voix...) </span></span><br />
<br />
<div class="separator" style="clear: both; text-align: left;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgdqd5vTaNNyRCZFG1YcUaxdMJnxMub-C6tCl95xkxc0A5CwOAsww0ZrWiYYaXpkfur3cxvodiW0mpjEFIbJXuTGePKBa2J4CWIa1CSzqGR5Ng8Laj8NjepcsymH6Z27ZXWI-0PbrZoxJs/s1600/PresentTense_ActiveVoice.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgdqd5vTaNNyRCZFG1YcUaxdMJnxMub-C6tCl95xkxc0A5CwOAsww0ZrWiYYaXpkfur3cxvodiW0mpjEFIbJXuTGePKBa2J4CWIa1CSzqGR5Ng8Laj8NjepcsymH6Z27ZXWI-0PbrZoxJs/s1600/PresentTense_ActiveVoice.jpg" /></a></div>
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><br />
<br />
<br />
<br />
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Allons, l'essentiel est que la collègue Sharon B. puisse continuer à organiser ses séminaires, ses brassages d'air et son "manque-pas-d'air" (voir ses commentaires, sous sa présentation Slideshare, lorsqu'on lui fait remarquer ses dérapages...)</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><br />
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br /></span></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjjZUFbrSqgnVAS740Lqe5yTRPm3XlRKKTqUoV0XeM6jIe_aUOfIzBPTndItQYC3QABZbxktLM2JHK867IJaZgQzbxb4JAx8buqE4nQOVen7E3iivkAabU0fFl4WKhaujgkHAokrSoa2nc/s1600/orthographe_importance.gif" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjjZUFbrSqgnVAS740Lqe5yTRPm3XlRKKTqUoV0XeM6jIe_aUOfIzBPTndItQYC3QABZbxktLM2JHK867IJaZgQzbxb4JAx8buqE4nQOVen7E3iivkAabU0fFl4WKhaujgkHAokrSoa2nc/s1600/orthographe_importance.gif" /></a></div>
<b><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">Cours particulier pour la chère Sharon :</span></span></span></span></b><br />
<br />
<b><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">(a) les phrases au futur :</span></span></b><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- The Widget will print the report</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- The Widget will save the file</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- The email will be sent if a network is found (futur composé)</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"></span></span><br />
<b><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"> (b) les phrases au présent (et à la voix active) :</span></span></b><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- These steps may prevent the brake pedal from functionning</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- Your report prints</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- During these steps, the brake pedal does not work</span></span><br />
<b><span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">(c) Phrases au passé composé (et au passif)</span></span></b><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- Your email is automatically sent the next time a network is found</span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">- The file is saved </span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"> </span></span><br />
<br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><b>Conclusion</b>, le minimalisme ne consiste<b><span style="color: #660000;"> pas à minimaliser l'application des règles </span></b>de </span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjzyK8JObhubRQkoafKPpHynrUmmuYEN_TbFGLdHLVEMyk1JqvTMb0HoPVa8chgEhhJ3oyOYGZPH4bNsaZ2HOcX9tDdoSriTjYlDiksRPdhxr0b6DUPECr3motrqyue4oZMrxKiQBKAxlA/s1600/grammaire_s.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjzyK8JObhubRQkoafKPpHynrUmmuYEN_TbFGLdHLVEMyk1JqvTMb0HoPVa8chgEhhJ3oyOYGZPH4bNsaZ2HOcX9tDdoSriTjYlDiksRPdhxr0b6DUPECr3motrqyue4oZMrxKiQBKAxlA/s1600/grammaire_s.jpg" /></a></span></div>
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;">grammaire et de conjugaison, mais à bien veiller que tout ce qui est écrit est</span> </span><span style="font-family: "Trebuchet MS",sans-serif;">grammaticalement correct.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"></span></span><br />
<span style="font-size: small;"><span style="font-family: "Trebuchet MS",sans-serif;"><br />Il faut que l'utilisateur comprenne facilement ce qui est indiqué, mais aussi que le traducteur n'ait pas à DEVINER ce que l'on a voulu dire...</span></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com2tag:blogger.com,1999:blog-4470063915169982637.post-81993526090499812352014-04-02T12:34:00.002+02:002014-07-06T10:34:18.161+02:00Découvrir l'intérêt des tests utilisateurs...<span style="font-size: large;">.<span style="font-family: Trebuchet MS, sans-serif;">.. ou lorsque la poule découvre l'oeuf</span></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Dans un article paru dans le N° 1 de la revue DOCUMENTALISTE - Sciences de l'information, </span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: Trebuchet MS, sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEghzM-1iVCIT4Xz5pzYv1ReJV3BHRsa1oHW70MXvvcy46oprCBEr0JjfDTeUiUVfBiM_bHPPlsMzrPuBRORwQLhOlUeYm-F2qhgk1_nhQu8bpzxIceMQju4F-0J76oPzuUTKPkt2drR6ws/s1600/Poule_Oeuf.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEghzM-1iVCIT4Xz5pzYv1ReJV3BHRsa1oHW70MXvvcy46oprCBEr0JjfDTeUiUVfBiM_bHPPlsMzrPuBRORwQLhOlUeYm-F2qhgk1_nhQu8bpzxIceMQju4F-0J76oPzuUTKPkt2drR6ws/s1600/Poule_Oeuf.jpg" /></a></span></div>
<span style="font-family: Trebuchet MS, sans-serif;">on trouve un article "<i>Communication et rédaction technique : test et oralité.</i>"</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Oralité et documentation technique</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Comme l'oralité en documentation technique relève du mystère, on poursuit la lecture.</span><br />
<blockquote class="tr_bq">
<span style="font-family: Trebuchet MS, sans-serif;">"<i>Les cursus devraient ...proposer des enseignements sur la collecte d'informations auprès d'utilisateurs réels, la gestion des réunions de suivi, la gestion des conflits, </i></span><span style="font-family: Trebuchet MS, sans-serif;"><i>l'organisation de tests, etc."</i></span></blockquote>
<span style="font-family: Trebuchet MS, sans-serif;">Si l'on entend "cursus" par "cursus universitaire", on ne peut que s'étonner d'une telle assertion. Nombreuses sont les <a href="http://www.sites.univ-rennes2.fr/lea/cfttr/?q=accueil">universités françaises</a> qui n'ont </span><span style="font-family: 'Trebuchet MS', sans-serif;">pas attendu 2014 -et le papier de l'auteur- pour enseigner l'art du "usability testing".</span><br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Assertion particulièrement odieuse lorsque l'on sait que la f</span><span style="font-family: 'Trebuchet MS', sans-serif;">ormation <a href="http://www.sites.univ-rennes2.fr/lea/cfttr/?q=node/98#overlay-context=node/87%3Fq%3Dnode/87">Master 2 Spécialisation Rédaction-Communication</a> de l'Université de Haute-Bretagne </span><span style="font-family: 'Trebuchet MS', sans-serif;">organise, non seulement des tests utilisateurs pendant les cours, mais effectue, avec les étudiants, des <a href="http://www.businesswire.com/news/home/20110518007124/fr/">tests de suivi oculaire.</a></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Qualité des documents</span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Trebuchet MS, sans-serif;">"La qualité des documents que nous avons produits n'a, quant à elle, pas toujours évolué positivement,alors même ...que </span><span style="font-family: 'Trebuchet MS', sans-serif;">les formations confirment que c'est la bonne manière de procéder... mais sans toujours expliquer comment y parvenir concrètement."</span></i></blockquote>
<span style="font-family: Trebuchet MS, sans-serif;">indique l'auteur.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgZLI5Y_kbBIv7rqCaKLQVnRmj_3Ukrky0gEwYGwfEmQqkFQhT4KQyppYb0jNOlBiAfZuL3EsmhUDA5Jm-jANEow9CY-m5-2fFIwBQg09z1rr3Fb06fiVfRpPyZpiaZTo9AnNcAmvZjYYk/s1600/a-village-school-ural-mountains.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgZLI5Y_kbBIv7rqCaKLQVnRmj_3Ukrky0gEwYGwfEmQqkFQhT4KQyppYb0jNOlBiAfZuL3EsmhUDA5Jm-jANEow9CY-m5-2fFIwBQg09z1rr3Fb06fiVfRpPyZpiaZTo9AnNcAmvZjYYk/s1600/a-village-school-ural-mountains.jpg" height="240" width="320" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">Effectivement, lorsque l'on vit depuis 20 ans dans une <a href="http://fr.wikipedia.org/wiki/Oural#L.E2.80.99Oural_septentrional">grotte de l'Oural septentrional</a>, on n'a pas accès </span><span style="font-family: 'Trebuchet MS', sans-serif;">aux publications sur le métier. </span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;">Par exemple, l'article <i>"Evaluer l'efficacité des documents techniques procéduraux : un panorama des méthodes" </i></span><span style="font-family: 'Trebuchet MS', sans-serif;">dans lequel on parle d' "<i>évaluation centrée sur l'utilisateur...réalisée à partir d'un échantillon d'utilisateurs provenant </i></span><span style="font-family: 'Trebuchet MS', sans-serif;"><i>du public-cible"</i> . Cet article date de 2002 !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Les enseignants, les rédacteurs ne savent pas </span><i><span style="font-family: 'Trebuchet MS', sans-serif;"> "expliquer comment y parvenir concrètement." ?</span></i><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="font-family: 'Trebuchet MS', sans-serif;">Pourtant, le Prof. Franck Ganier -qui, lui, a de la méthode- précise :</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<i><span style="font-family: Trebuchet MS, sans-serif;">"Les méthodes basées sur l'implication d'utilisateurs dans l'évaluation sont destinées à vérifier si les caractéristiques du document sont suffisamment adaptées aux caractéristiques perceptives et cognitives des </span><span style="font-family: 'Trebuchet MS', sans-serif;">utilisateurs impliqués dans la recherche ou la compréhension des informations..."</span></i><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">De même, <a href="http://www.utc.fr/reseau-aide/ganier.PDF">Franck Ganier</a> indique, dans son article "</span><span style="font-family: 'Trebuchet MS', sans-serif;"><i>De l'analyse des fonctionnements cognitifs à l'ergonomie des aides opératoires</i>" (janvier 2002) :</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<i><span style="font-family: 'Trebuchet MS', sans-serif;">"Sur le plan ergonomique, l’utilisation de ce modèle comme </span><span style="font-family: 'Trebuchet MS', sans-serif;">support à la conception de documents a permis de réaliser des documents procéduraux plus </span><span style="font-family: 'Trebuchet MS', sans-serif;">performants en termes d'aide opératoire, tant au niveau de la recherche d'informations qu'au </span></i><i style="font-family: 'Trebuchet MS', sans-serif;">niveau de leur lecture / utilisatio</i><span style="font-family: 'Trebuchet MS', sans-serif;">n."</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="font-family: 'Trebuchet MS', sans-serif;">Ainsi donc, les formateurs sont bien capables de fournir des méthodes, basées sur des tests utilisateurs, pour améliorer la qualité de la documentation produite... et ceci depuis des décennies !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Processus centré sur les tests</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Dans certaines parties de France, le temps s'est arrêté. L'auteur pose -en 2014- ainsi la question :</span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Trebuchet MS, sans-serif;">"N'est-il pas temps que les désormais nommés </span><span style="font-family: 'Trebuchet MS', sans-serif;">"communicateurs techniques" s'attaquent à ce problème de communication pour le résoudre en mettant en place ce qui est nécessaire et indispensable : un processus centré sur le test ?"</span></i></blockquote>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgDHV-qPrLdzfPM5IOU8vwd-P5oAszvJAZSwmEVD6WVhVSKVDycgrYpcCGqo-VPx4o9jtozoQ1cSL5voVnEDx6lQW-rBxeemGq28akeF69ZO8MZRcQxk5TvZZ3JtX1jFMdJzJm591aAfhw/s1600/Faire_Tests.png" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgDHV-qPrLdzfPM5IOU8vwd-P5oAszvJAZSwmEVD6WVhVSKVDycgrYpcCGqo-VPx4o9jtozoQ1cSL5voVnEDx6lQW-rBxeemGq28akeF69ZO8MZRcQxk5TvZZ3JtX1jFMdJzJm591aAfhw/s1600/Faire_Tests.png" height="192" width="320" /></a></div>
<span style="font-family: 'Trebuchet MS', sans-serif;">Mais savez-vous, cher gloseur, que le manuel "<a href="http://books.google.fr/books/about/A_Practical_Guide_to_Usability_Testing.html?id=4lge5k_F9EwC&redir_esc=y">A practical guide to usability testing</a>" (Joseph S. Dumas et Janice C. Redish) </span><span style="font-family: 'Trebuchet MS', sans-serif;">a été publié en 1993 ?... il y a 20 ANS ! et que ce manuel est fortement recommandé dans les formations à la rédaction technique ??? </span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;">Des générations entières de rédacteurs techniques ont appris à faire des tests auprès de leurs utilisateurs AVANT votre publication de 2014 !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">En disant</span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Trebuchet MS, sans-serif;"> "C'est pourquoi le test s'avère incontournable pour contrôler que (sic) le résultat théorique attendu est bien obtenu en réalité... mais ceci de manière </span><span style="font-family: 'Trebuchet MS', sans-serif;">systématique, en l'intégrant au processus"</span></i></blockquote>
<span style="font-family: 'Trebuchet MS', sans-serif;"> l'auteur enfonce des portes ouvertes. Tout ceci a été étudié et documenté bien plus sérieusement </span><span style="font-family: 'Trebuchet MS', sans-serif;">dans le recueil <a href="http://www.amazon.fr/Comprendre-documentation-technique-Franck-Ganier/dp/2130617697/ref=sr_1_1?ie=UTF8&qid=1396433384&sr=8-1&keywords=Comprendre+la+documentation+technique">"Comprendre la documentation technique</a>" (Ed. PUF, 2013)</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Question oralité... on reste bouche bée</span><br />
<blockquote class="tr_bq">
<span style="font-family: Trebuchet MS, sans-serif;"><i>"Il me semble indispensable de mettre l'accent sur les compétences orales des futurs rédacteurs... L'aisance à l'oral est malheureusement la grande oubliée"</i></span></blockquote>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEijJiulG74G3w-FrTYp3YwFRJ0QGMP74DBxYm0t29HDuEU7ZOqc9hIVRd3XuMxAuFEwM2DBJOmQ98lmOPH8jcYpmnYJ_H6Hj4O72fBLAp7aYUKOmlMt0ygUX9Ues0eG0NcJYGyyocwQft4/s1600/BoucheBee.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEijJiulG74G3w-FrTYp3YwFRJ0QGMP74DBxYm0t29HDuEU7ZOqc9hIVRd3XuMxAuFEwM2DBJOmQ98lmOPH8jcYpmnYJ_H6Hj4O72fBLAp7aYUKOmlMt0ygUX9Ues0eG0NcJYGyyocwQft4/s1600/BoucheBee.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">Voilà encore une belle assertion ! </span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Dans les bonnes formations à la rédaction technique, on travaille avec un manuel -qui a échappé à la sagacité de l'auteur de l'article- </span><span style="font-family: 'Trebuchet MS', sans-serif;">et qui date de 1998 : <a href="http://www.amazon.fr/User-Task-Analysis-Interface-Design/dp/0471178314/ref=sr_1_1?s=english-books&ie=UTF8&qid=1396433546&sr=1-1&keywords=User+and+task+analysis">"User and Task Analysis for Interface Design</a>" (JoAnn Hackos et Janice Redish). </span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;">Dans son chapitre 6, on lit "</span><i style="font-family: 'Trebuchet MS', sans-serif;">Interviewing users and others".</i><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">De plus, pour les personnes qui ne sont pas en décalage horaire et temporel permanent : un manuel dédié à l'interview d'utilisateurs a été publié en 2013. "<a href="http://www.amazon.fr/Interviewing-Users-Uncover-Compelling-Insights-ebook/dp/B00CEKR872/ref=sr_1_1?s=english-books&ie=UTF8&qid=1396433774&sr=1-1&keywords=Interviewing+Users+-+How+to+uncover+compelling+insights%22">Interviewing Users - How to uncover compelling insights"</a>. A</span><span style="font-family: 'Trebuchet MS', sans-serif;">uteur Steve Portigal, éditeur : Rosenfeld.</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Extraits :</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><i> "User Insight in the Design Process", "When to use interviewing", "The Impact of interviewing", "More than just asking questions", etc.</i></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><i><br /></i></span>
<span style="font-family: Trebuchet MS, sans-serif;">Pensez-vous qu'avec tout cela, on ne saurait pas vraiment interviewer un utilisateur ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Alors, en matière de tests et d'utilisabilité, tout a été dit, analysé, discuté. Pourquoi tenter de </span><span style="font-family: 'Trebuchet MS', sans-serif;"> </span><span style="font-family: 'Trebuchet MS', sans-serif;">(mal) </span><span style="font-family: 'Trebuchet MS', sans-serif;">ré-inventer la roue ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Quels tests ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Ce qui est particulièrement décoiffant dans cet article, c'est l'imprécision : il est question de test, mais de quels tests ? Tests de résistance ? Tests d'orthographe ? Tests de lisibilité ?...</span><br />
<span style="font-family: Trebuchet MS, sans-serif;">Les véritables </span><span style="font-family: 'Trebuchet MS', sans-serif;">professionnels appellent cela des _tests d'utilisabilité_ ("usability tests").</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Les champions du domaine, outre les auteurs cités, sont <a href="http://www.nngroup.com/articles/usability-101-introduction-to-usability/">Jakob Nielsen</a> et, plus récemment, <a href="http://www.customercarewords.com/">Gerry McGovern.</a> Aucun d'entre eux n'est cité dans l'article... ce qui dénote un sérieux manque de professionnalisme.</span><br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large;">Minimalisme et tests d'utilisabilité ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Et bien oui, après un premier jet d'un guide utilisateur, on procède à des tests d'utilisabilité en sélectionnant des utilisateurs lambda à qui l'on confie une tâche précise. En suivant le manuel, ils doivent être </span><span style="font-family: 'Trebuchet MS', sans-serif;">en mesure d'obtenir le résultat escompté. Si l'utilisateur trébuche, le rédacteur a mal fait son travail... that's all!</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Ceci est documenté dans l'article de Stephanie Rosenbaum "<i>Follow-up on Training in Minimalism"</i> (in <i>Minimalism beyond the Nurnberg Funne</i>l) où elle parle de "<i>conducting usability testing prior to release</i>", "<i>talking to users before and after </i></span><i style="font-family: 'Trebuchet MS', sans-serif;">instituded minimalist documentation</i><span style="font-family: 'Trebuchet MS', sans-serif;">" ou "</span><span style="font-family: 'Trebuchet MS', sans-serif;"><i>sending out 100 user surveys</i></span><span style="font-family: 'Trebuchet MS', sans-serif;">".</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: large;">Norme ISO 26 514 et les "Usability tests"</span><br />
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: large;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Délibérément, l'auteur décide d'ignorer tous les travaux de recherche dans le domaine des tests et de l'art d'interviewer les utilisateurs. C'est son choix.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Mais pousser l'outrecuidance à ignorer la norme ISO 26 514 "<i>Ingénierie du logiciel et des systèmes - Exigences pur les concepteurs et les développeurs de la documentation de l'utilisateur" </i>qui, au point 8.3.2, sous "<i>Usability tests" </i>indique :</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><i>"User tests are the most acceptable method of checking that the information provided in the documentation is what users need..."</i></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><i><br /></i></span>
<span style="font-family: Trebuchet MS, sans-serif;">cela frôle l'incompétence ! Notons par ailleurs que cette norme date de 2008 et qu'elle constitue, dans plusieurs universités françaises (*), le "bréviaire" de la rédaction technique.</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjhyphenhyphenpNUdLXocaMXbBDEA5-8ma3q7Txzm053moawAYTSn_k189HS84HGY15tM8zG-FTV7dxKNYS4Tc8qScouvMx6PxUBMWgGOs_GrqqdOjBUBga0xfoJ0QFbBGqJB3cP7H5A8_Dj-JjymnI/s1600/Nombrilisme.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjhyphenhyphenpNUdLXocaMXbBDEA5-8ma3q7Txzm053moawAYTSn_k189HS84HGY15tM8zG-FTV7dxKNYS4Tc8qScouvMx6PxUBMWgGOs_GrqqdOjBUBga0xfoJ0QFbBGqJB3cP7H5A8_Dj-JjymnI/s1600/Nombrilisme.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Alors, on sort de sa grotte, on délaisse le nombrilisme et l'on regarde hors de son périmètre ... en commençant par faire un tour dans une bonne bibliothèque ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span><span style="font-family: Trebuchet MS, sans-serif;">___________________</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><span style="font-size: x-small;">(*) Université de Bretagne Occidentale, Université de Haute-Bretagne, Université Catholique de l'Ouest, entre autres...</span></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-34565584447757439012014-03-20T14:46:00.000+01:002014-10-28T21:56:03.636+01:00Jeter aux orties les Vues d'ensemble et Introductions ?<span style="font-family: Trebuchet MS, sans-serif; font-size: large;">Savez-vous ce que pensent les utilisateurs de vos sections "<b>Vue d'ensemble</b>", "<b>Généralités</b>" ou "<b>Introduction</b>" ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="color: #660000; font-size: large;">RIEN </span>! Ils négligent, ils rejettent, ils ignorent... Ils ne lisent PAS toutes ces formes de préambules (les ingrats !)</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Alors, pourquoi les inclure ? Pourquoi obliger les utilisateurs à feuilleter une dizaine de pages avant d'arriver à l'essentiel : "comment faire pour..."</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Voici ce qu'en pense notre collègue Larry Kunz (extrait d'un message sur Twitter) :</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjBx26AMr3FFl3wt4EPv2T1a56twVKMGx3343IXdt9k8I1TMSXc1wcH-8oYVNE_KD3S1iObhatJH8vqc3C-LnktjgMaLaH6b1yolc0ksPgQsRw6X86jV8aTUVmW47M8oOxgkDAxJ09rd1M/s1600/NoOverview_EnterA_Bar.png" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjBx26AMr3FFl3wt4EPv2T1a56twVKMGx3343IXdt9k8I1TMSXc1wcH-8oYVNE_KD3S1iObhatJH8vqc3C-LnktjgMaLaH6b1yolc0ksPgQsRw6X86jV8aTUVmW47M8oOxgkDAxJ09rd1M/s1600/NoOverview_EnterA_Bar.png" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span><span style="font-family: Trebuchet MS, sans-serif;">Alors, si le consommateur n'a pas besoin d'une <b>Vue d'Ensemble</b> avant de commander une bière, est-ce que l'utilisateur a besoin d'une introduction avant </span><span style="font-family: 'Trebuchet MS', sans-serif;">d'utiliser le produit ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large; font-weight: normal;">Superfétatoire, l'introduction ?</span></h3>
<span style="font-family: Trebuchet MS, sans-serif;">Voici un e</span><span style="font-family: 'Trebuchet MS', sans-serif;">xemple d'une introduction superfétatoire (il s'agit d'un manuel utilisateur d'un logiciel de création documentaire) :</span><br />
<blockquote class="tr_bq" style="text-align: left;">
<span style="font-family: Courier New, Courier, monospace;"><b><span style="color: #660000;">Introduction</span><br /><span style="color: #660000;">Ce guide est la documentation de la chaîne éditoriale XYZ. Elle regroupe :</span></b></span><br />
<ul><span style="font-family: Courier New, Courier, monospace;"><b>
<li><span style="color: #660000;">Une introduction sur les fonctionnalité de XYZ et l'apport d'une chaîne éditoriale dans la rédaction des documents d'aide utilisateur d'un logiciel</span></li>
<li><span style="color: #660000;">Une présentation de l'interface utilisateur d'XYZ</span></li>
<li><span style="color: #660000;">Les procédures fondamentales d'utilisation de l'application</span></li>
</b></span></ul>
<span style="font-family: Courier New, Courier, monospace;"><b>
</b></span></blockquote>
<span style="font-family: Trebuchet MS, sans-serif;">Donc, l'utilisateur a fait l'acquisition du produit XYZ. Normalement, à ce stade, il sait ce qu'il a acheté et a une certaine connaissance de ce qu'il peut faire </span><span style="font-family: 'Trebuchet MS', sans-serif;">avec ce produit. Avec le logiciel XYZ, il ne va pas chercher à faire du café ni à démontrer l'universalité de la théorie de la relativité...</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Alors que le titre du manuel est <i>"Documentation utilisateur de XYZ</i>", est-il nécessaire de rappeler </span><span style="font-family: 'Trebuchet MS', sans-serif;">en page 8 : "<i>Ce guide est la documentation utilisateur de...</i>"</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">En introduction, on explique ensuite que, dans le manuel, il y a une introduction sur les fonctionnalités... Introduction seulement ? Et le coeur des fonctionnalités, il est où ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large; font-weight: normal;">Présentation ... pour quoi faire ?</span></h3>
<span style="font-family: 'Trebuchet MS', sans-serif;">Après l'introduction à l'introduction, nous avons la <i> Présentation</i> ... non pas du logiciel, </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgu1Eftvi35tnCjkzADjcmQ-MwrPzAUo1l78CktWRk_4J8yv46di9XygF-AUKtak6EJWo3cvRd1T864kGxBDKFiXO6M0hPpUabiqEJx6y9yrXNzu4IrQ5wfHyAEHjwkSmYpMc32xBJwnCo/s1600/Volume_Documentation.gif" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgu1Eftvi35tnCjkzADjcmQ-MwrPzAUo1l78CktWRk_4J8yv46di9XygF-AUKtak6EJWo3cvRd1T864kGxBDKFiXO6M0hPpUabiqEJx6y9yrXNzu4IrQ5wfHyAEHjwkSmYpMc32xBJwnCo/s1600/Volume_Documentation.gif" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">mais de l'interface. Intéressant. L'utilisateur a déjà l'écran en face de lui et maintenant </span><span style="font-family: 'Trebuchet MS', sans-serif;">on lui explique ce qu'il a devant les yeux. </span><i style="font-family: 'Trebuchet MS', sans-serif;">"L'option IMPRIMER sert à imprimer</i><span style="font-family: 'Trebuchet MS', sans-serif;">", "</span><i style="font-family: 'Trebuchet MS', sans-serif;">L'option EDITER sert à éditer</i><span style="font-family: 'Trebuchet MS', sans-serif;">", etc.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Sachant que les PC grand public sont arrivés en Europe dans les années '90, on est tenté de croire que, depuis le temps, l'utilisateur a assimilé les bases d'un travail avec l'interface.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Voyez ce qu'en pensent les spécialistes de l'ergonomie des interfaces graphiques :</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgfdxXd1FkZjf_KZK8GC0X8SC2m0rDKc_0x9SD3JTqpxIL1J076sDI82-INsPJblkfowX45HwM3dvAu2aGDbMI8mmURWB7IOYtqCDwl_dKg4qkcQ3v2SI_tVMdPxMDH4shM1SgPAV9z3ZQ/s1600/NoDescriptionOfUI.PNG" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgfdxXd1FkZjf_KZK8GC0X8SC2m0rDKc_0x9SD3JTqpxIL1J076sDI82-INsPJblkfowX45HwM3dvAu2aGDbMI8mmURWB7IOYtqCDwl_dKg4qkcQ3v2SI_tVMdPxMDH4shM1SgPAV9z3ZQ/s1600/NoDescriptionOfUI.PNG" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span><span style="font-family: Trebuchet MS, sans-serif;">Pour terminer, nous découvrons (enfin !) les procédures fondamentales (<span style="font-size: x-small;">question de la béotienne que je suis : quand elles ne sont pas fondamentales, les procédures, que sont-elles ?</span>) </span><span style="font-family: 'Trebuchet MS', sans-serif;">...et là, l'utilisateur est ébahi : dans un manuel utilisateur il trouve des PROCEDURES ! Quel bonheur !... c'est ce qu'il recherche depuis 15 minutes !</span><br />
<span style="font-family: 'Trebuchet MS', sans-serif;"><br /></span>
<br />
<h3>
<span style="color: #660000; font-family: Trebuchet MS, sans-serif; font-size: large; font-weight: normal;">Le titre ...</span></h3>
<span style="font-family: 'Trebuchet MS', sans-serif;">Tout aussi édifiant, parfois, est le titre.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Ce grand industriel allemand, fabricant d'antennes de transmission sans fil par micro-ondes</span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: Trebuchet MS, sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiTLWqIq6BtFzcM4kZRXcg7OVRj5HHVoXpMv_klxfP-5xVIrLQ9ryDACrQJ7QvyhKiXrRDZlLAHdPisgMWPQ8HIkbFbN_w40euJNj_J-dIvaky4ZoAa6KnIXlDqVwaVO1nCytSjWftdaBI/s1600/SafetyManualForUserGuide_Siemens.png" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiTLWqIq6BtFzcM4kZRXcg7OVRj5HHVoXpMv_klxfP-5xVIrLQ9ryDACrQJ7QvyhKiXrRDZlLAHdPisgMWPQ8HIkbFbN_w40euJNj_J-dIvaky4ZoAa6KnIXlDqVwaVO1nCytSjWftdaBI/s1600/SafetyManualForUserGuide_Siemens.png" height="320" width="315" /></a></span></div>
<span style="font-family: Trebuchet MS, sans-serif;"> (<a href="http://en.wikipedia.org/wiki/WiMAX">WiMAX</a>) </span><span style="font-family: 'Trebuchet MS', sans-serif;">indique, en titre de son guide :"<i>Safety precautions for User Guide</i>". Oui, vous avez bien lu : "<i>Précautions de sécurité pour le guide utilisateur</i>".</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">... nous les professionnels de la rédaction le savons pertinemment : un manuel utilisateur est un OBJET DANGEREUX ! </span><span style="font-family: 'Trebuchet MS', sans-serif;">On ne peut travailler qu'avec moultes assurances-vie.</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">A votre avis, n'est-il pas temps de cesser de produire de l'information inutile et de revoir nos contenus ? </span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><b><span style="color: #38761d;">________________________________</span></b></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><b><span style="color: #38761d;"> </span></b></span>
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Le <b><span style="color: #990000;">prochain atelier</span></b> "<i>Minimalisme : créer l'information dont on a vraiment besoin</i>" aura lieu les <b><span style="color: #990000;">15-16 décembre 2014 à Vélizy (Paris</span></b>) chez<a href="http://www.nmj.fr/metiers/synthese/puzzle.html"> NMJ Services</a>. Les <a href="http://comtech-serv.com//index.php?main_page=index&cPath=28_1_146_152">inscriptions sont ouvertes !</a></span>
<br />
<br />
<br />
<br />Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-52334801828119224292014-03-12T18:39:00.001+01:002014-10-28T22:00:36.704+01:00Booster l'efficacité de votre documentation !<span style="font-family: Trebuchet MS, sans-serif;">Vous souhaitez actualiser, autour d'un café-palmiers, votre savoir-faire pour optimiser votre documentation produits en passant au minimalisme !</span><br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhn-UZnqfCeVDIpLIMPA4FuQ-6MxC_ynf9r_aIrsXu1mQpqaqP4Nv7I7nmPU8TySBBB28AZuFFdN3NxXeIAacHa8bhM5vWPULlTKWUSBXfoSSrhQJq6U28SwLofdE_mi-Wc7EgkQ8wpkeg/s1600/DilbertDailyStrip20090315_ExpensiveDocumentation.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhn-UZnqfCeVDIpLIMPA4FuQ-6MxC_ynf9r_aIrsXu1mQpqaqP4Nv7I7nmPU8TySBBB28AZuFFdN3NxXeIAacHa8bhM5vWPULlTKWUSBXfoSSrhQJq6U28SwLofdE_mi-Wc7EgkQ8wpkeg/s1600/DilbertDailyStrip20090315_ExpensiveDocumentation.jpg" /></a></div>
<br />
<span style="font-family: Trebuchet MS, sans-serif;"> Faites<a href="mailto:flacke@orange.fr">-le savoir !</a></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;"><span style="color: #660000;"><b>Topic :</b> </span>au centre des discussions, le volume de la documentation, son coût, son utilité et le feedback de vos utilisateurs.</span><br />
<div class="separator" style="clear: both; text-align: left;">
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif;"><b><br /></b></span></div>
<div class="separator" style="clear: both; text-align: left;">
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif;"><b>Avant-goût</b> </span><span style="font-family: 'Trebuchet MS', sans-serif;">: la documentation minimaliste et structurée ne s'applique pas à votre domaine ? ... Jetez un oeil sur ces exemples :</span></div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">- Transformation d'une documentation-fleuve en une <a href="http://www.screencast.com/t/YROPxr4a1R">documentation structurée </a></span><br />
<span style="font-family: Trebuchet MS, sans-serif;">- Passage d'une documentation romancée à une <a href="http://www.screencast.com/t/zyrhZw6GGAJ">documentation minimaliste (enfin !)</a></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"></span><br />
<br /><span style="font-family: Trebuchet MS, sans-serif;"><b><span style="font-family: Trebuchet MS, sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">____________________________________________</span></b></span></span></b></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Pour en parler,<b> <a href="mailto:flacke@orange.fr">faites-nous signe !</a></b></span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><b><span style="font-family: Trebuchet MS, sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">____________________________________________</span></b></span></span> </b></span><br />
<br /><span style="font-family: Trebuchet MS, sans-serif;">Vous n'avez pas besoin de passer votre documentation à la <a href="http://users.edte.utwente.nl/meij/minimalism.htm">grille du minimalisme</a> ? C'est ce que pensaient les rédacteurs du site nucléaire <a href="http://en.wikipedia.org/wiki/Three_Mile_Island_accident">Three-Mile-Island</a>.</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgVt04XdYOwgaiPqkfnrP5UWzMoJ2OJDGNL4-lNhagn6RbfRJmCGTAc4hHtFs4CDGmZTfd98jrvvTPtX8f29PnipJQrkalCfSI9wUyXr7yzlPceLixNDheqoSfEz6oAIbqgsGNo5QjuQj4/s1600/Three-Mile-Island.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><span style="font-family: Trebuchet MS, sans-serif;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgVt04XdYOwgaiPqkfnrP5UWzMoJ2OJDGNL4-lNhagn6RbfRJmCGTAc4hHtFs4CDGmZTfd98jrvvTPtX8f29PnipJQrkalCfSI9wUyXr7yzlPceLixNDheqoSfEz6oAIbqgsGNo5QjuQj4/s1600/Three-Mile-Island.jpg" height="133" width="200" /></span></a></div>
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Selon l'émission <a href="http://www.franceculture.fr/emission-planete-terre-sommes-nous-prepares-a-d-autres-fukushima-2014-03-12">Planète Terre</a>, dans la salle de contrôle du site nucléaire, au moment de la catastrophe et alors que tous les voyants étaient au rouge, les ingénieurs devaient lire<b> un manuel de 150 pages</b> ! ... malaise, vous avez dit malaise ?</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">________________________________________________ </span></b></span></span><br />
<br />
<span style="font-family: Trebuchet MS, sans-serif;">Le prochain atelier "<i>Minimalisme : créer l'information dont on a vraiment besoin</i>" aura lieu les <b><span style="color: #990000;">15-16 décembre 2014 à Vélizy (Paris)</span></b> et se tiendra en français. Les <a href="http://www.nmj.fr/metiers/synthese/puzzle.html">inscriptions sont ouvertes !</a> </span><br />
<br />Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-34545822062296227842014-03-07T21:12:00.000+01:002014-09-11T21:21:38.038+02:00Minimalisme, qualité et lisibilité (...foutaises ?)<h3>
<span style="color: #660000;"><span style="font-weight: normal;">En parlant minimalisme, on entend souvent : c'est réduire la longueur des mots !</span></span></h3>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgT1FGd6Y5sWi5uuGW4VWys_3UcqgOWe7S9DbH-LDLKZ8bs2NMs0PCNh0LFnk4dodvS18YzbN8KNI3VaPIfxxCqeshexc0qpI9l_MPjVw04YPcR8lPT_R39-yeU1qvbQWn4zrbzkMwIK_g/s1600/Mots_Tres_Longs.JPG" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgT1FGd6Y5sWi5uuGW4VWys_3UcqgOWe7S9DbH-LDLKZ8bs2NMs0PCNh0LFnk4dodvS18YzbN8KNI3VaPIfxxCqeshexc0qpI9l_MPjVw04YPcR8lPT_R39-yeU1qvbQWn4zrbzkMwIK_g/s1600/Mots_Tres_Longs.JPG" height="146" width="320" /></a></div>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Et bien non, ce n'est absolument pas cela. Tous les mots, à partir du moment où ils sont compris et utilisés par l'utilisateur final sont utilisables dans une documentation technique.<br /><br />En matière de longueur des mots, quelques <a href="http://www.contentrules.com/blog/quality-content-eye-consumer/?utm_medium=email&utm_campaign=February+2014+Newsletter&utm_content=February+2014+Newsletter+CID_91f1b415bdac24495abec2da561568cb&utm_source=Email%20marketing%20software&utm_term=Quality%20Content%20is%20in%20the%20Eye%20of%20the%20Consumer">esprits qui s'autorisent à penser pour les autres</a>, nous recommandent l'emploi de<b> tests de lisibilité</b> pour mesurer la qualité de la documentation technique. Vous savez, les tests de Flesch-Kincaid, Fog, etc.<br /><br />On dispose même d'outils disponibles en ligne qui <a href="http://www.standards-schmandards.com/exhibits/rix/">"calculent" le taux de lisibilité</a> d'un document. Amusant, non ? Pour la langue française, choisissez (sous "Method") l'option Kandel & Moles.</span><br />
______________________________________________________________________________<br />
<h3>
<span style="font-weight: normal;"><span style="color: #660000;">Malheureusement, ces petits joujoux ne résistent pas à un examen un peu approfondi</span></span></h3>
<span style="font-weight: normal;"><span style="color: #660000;"></span></span><span style="font-family: "Trebuchet MS",sans-serif;">En effet, les tests sont basés sur 2 critères : </span><br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;">la longueur des phrases </span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;">la longueur des mots. </span></li>
</ul>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Plus le mot est long, plus il est considéré comme "difficile" à comprendre. Comme l'indique</span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg7SwKUv2JiSUToZ568AtepiApfxlxbRq6Xvqaq-TkkbPcZYgZOeG87htT6vePzCCceOWklb_bYg4zLf75Ial_925-13XI34oNGpYmxU-t28JArH6umJSavZHlkQcGwZ3_dJIgz7JN75W4/s1600/longuestWord.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEg7SwKUv2JiSUToZ568AtepiApfxlxbRq6Xvqaq-TkkbPcZYgZOeG87htT6vePzCCceOWklb_bYg4zLf75Ial_925-13XI34oNGpYmxU-t28JArH6umJSavZHlkQcGwZ3_dJIgz7JN75W4/s1600/longuestWord.jpg" height="160" width="320" /></a></div>
le Prof. Franck Ganier : <br />
<i>"... plus les phrases sont longues et le vocabulaire complexe, moins le texte est "lisible"</i> .<br />
<br />
Soit, mais en y regardant de plus près, selon F. Ganier (*) :<br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;">"<i>si l'on considère que ces formules ont été créées à l'origine pour déterminer le niveau de lecture correspondant à des textes écrits pour des manuels scolaires, on peut s'interroger sur la pertinence et la validité de leur usage pour l'évaluation de documents techniques". </i></span></blockquote>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Erreur d'aiguillage, donc. C'est applicable aux manuels scolaires et pas transposable en rédaction technique.<i><br /></i></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhbqfXqEPHmNBNVderBwaQOLcrA-mfq7mSsxwhyqiBkBgFvtA0ID7PMHCbO8Br9tO4IsWVO2zTryENBQ_RPFYSvETtVXB1ozTefkb0b_S2UMizjrt_mrzaOViTblJwgExPLTWxx1dy0MPA/s1600/17DFA7-intelligible.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhbqfXqEPHmNBNVderBwaQOLcrA-mfq7mSsxwhyqiBkBgFvtA0ID7PMHCbO8Br9tO4IsWVO2zTryENBQ_RPFYSvETtVXB1ozTefkb0b_S2UMizjrt_mrzaOViTblJwgExPLTWxx1dy0MPA/s1600/17DFA7-intelligible.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><br />De plus, ces tests n'ont été conçus que<b> pour la langue anglaise</b>, qui a une bien autre structure que le français ! Le test de Kandel et Moles n'est qu'une (piètre) adaptation.<br /><br />Par ailleurs, Ginny Redish, dans un article datant des années '80 (**) descend en flammes la pertinence de ces tests :</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"><i>"A formula that counts only sentence length and word length or familiarity of the words is not sensitive to the order of the words or the complexity of the grammar. Sentences with misplaced clauses, dangling participles, or misused words will score as well on a readability formula as sentences of equal length that have none of these problems</i>".</span></blockquote>
_____________________________________________________________________________<br />
<br />
<h2>
<span style="font-family: "Trebuchet MS",sans-serif;">Gadgets ?</span></h2>
<span style="font-family: "Trebuchet MS",sans-serif;">Nous voilà en présence de gadgets puisque ces "tests" ne tiennent compte que de la longueur des mots, mais pas de leur position dans la phrase...<br /><br />In fine, prenons un exemple : le terme "<b>excipients</b>" doit être considéré comme simple à comprendre puisqu'il ne dépasse pas les 3 syllabes en français. Par contre, le terme </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiSIHs02t9W0hB_EULjYI43q1KK-XghVqa5RKG3RTq92t78maVuapVq6-4p3ElnxZ8VY-9YNObE_stkfE0d7qfF3uiMsXUbO1MyIZi5atpjdRuEY2lnA4vRiD56Zlo8mF-lSOU1qn6wHNI/s1600/electrocardiogramme.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiSIHs02t9W0hB_EULjYI43q1KK-XghVqa5RKG3RTq92t78maVuapVq6-4p3ElnxZ8VY-9YNObE_stkfE0d7qfF3uiMsXUbO1MyIZi5atpjdRuEY2lnA4vRiD56Zlo8mF-lSOU1qn6wHNI/s1600/electrocardiogramme.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;"><b>"électrocardiogramme</b>", qui en compte 6, sera estampillé _difficile_. Or, dans la réalité, demandez à un quidam ce qu'il entend par "excipients" et par "électrocardiogramme"...Ce n'est certainement pas le plus long qui pose problème !</span><br />
<span style="font-family: Trebuchet MS, sans-serif;"><br /></span>
<span style="font-family: Trebuchet MS, sans-serif;">Alors, en conclusion, on ne va pas inclure, dans notre projet d'évaluation de la qualité de la documentation minimaliste, de tests de lisibilité... sauf pour s'amuser.</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Et l'on ne va pas passer notre temps à raccourcir les mots pour faire plaisir à Messieurs Flesch et Kincaid !</span><br />
<br />
<br />
<br />
____________________________________________________________________________<br />
(*) "Evaluer l'efficacité des documents techniques procéduraux: un panorama des méthodes", PUF, Le Travail humain, 2002/1, Vol.65<br />
(**) "Understanding the limitations of readability formulas", in IEEE Transactions on professional communication, 1981,vol. 2 <br />
<br />
Voir aussi: "<a href="http://www.amazon.fr/Comprendre-documentation-technique-Franck-Ganier/dp/2130617697/ref=sr_1_1?s=books&ie=UTF8&qid=1394220484&sr=1-1&keywords=Comprendre+la+documentation+technique">Comprendre la documentation technique</a>", Franck Ganier, Editions PUFMarie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-44965625702806846632014-02-17T22:34:00.001+01:002014-08-19T09:35:42.716+02:00Le minimalisme expliqué par un Ch'ti (*)<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"><span style="color: #660000;">Qui ici a lu une fois dans sa vie un mode d'emploi en entier ? </span></span></span></h3>
<br />
<span style="font-weight: normal;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">C'est la question</span></span></span> <span style="font-weight: normal;"><span style="font-family: "Trebuchet MS",sans-serif;">posée par l'acteur Dany Boon </span></span><span style="font-family: "Trebuchet MS",sans-serif;"><a href="http://www.youtube.com/watch?v=XKg3QZGy-Ks&feature=youtu.be">dans son interview d'un éminent rédacteur technique</a></span>.<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">L'acteur compatissant analyse avec le rédacteur technique (au bord du désespoir : 60 ans </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgdhXrFBbdn68RlG8DXIlOgvzLCXDgzK6QbXad8Q2eNVZrHDn3_JvdJn7Gx9UPVSJtGPRrMnAqB9jY09FB_ZDeiEkBlrk8gxnVjp7HL52WP6Y1nAjINJLZer6_lLCN0gsv01D-47XBRyR8/s1600/DanyBoon.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgdhXrFBbdn68RlG8DXIlOgvzLCXDgzK6QbXad8Q2eNVZrHDn3_JvdJn7Gx9UPVSJtGPRrMnAqB9jY09FB_ZDeiEkBlrk8gxnVjp7HL52WP6Y1nAjINJLZer6_lLCN0gsv01D-47XBRyR8/s1600/DanyBoon.jpg" height="111" width="200" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">de rédaction et personne n'a jamais lu un seul manuel en entier !..) le contenu d'un de ses guides utilisateurs. Celui destiné à l'utilisateur d'un micro-onde.</span><br />
<br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Après le "Démarrage rapide" (3.07e minute), on passe allègrement au chapitre 2</span>.<span style="font-family: "Trebuchet MS",sans-serif;"> </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">Il y est clairement indiqué :</span><br />
<br />
<div style="text-align: center;">
<i><span style="font-family: "Trebuchet MS",sans-serif;">"Mettre les aliments à réchauffer à l'intérieur du micro-ondes"</span></i></div>
<h3>
<span style="font-size: small; font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><b><span style="color: #38761d;">_____________________________________________________________________</span></b></span></span></span></h3>
<h3>
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">Ne donner à l'utilisateur que ce dont il a besoin ! </span></span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;">C'est le principe de base du minimalisme : uniquement ce dont l'utilisateur a besoin. </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">En effet, l'utilisateur du micro-onde a-t-il <b>besoin d'apprendre</b>, dans un manuel en 5 langues, que, pour réchauffer des aliments, il faut les <b>déposer à l'intérieur de l'appareil</b> </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjvEhkDQKxZBZtHv-G9MPY7Y3Hq-6Jpd31ITvlI0Fr7nAqPChNlZF6vwGc7CaUP9yABZIpTI5I8stSSWiFBZwaxlabNS0R-VajPEOMF5vEMdQD7ZTjhy8roohnIL40CkGDhSg_72Sj7Vvg/s1600/8525364-an-image-of-a-dirty-microwave-oven.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjvEhkDQKxZBZtHv-G9MPY7Y3Hq-6Jpd31ITvlI0Fr7nAqPChNlZF6vwGc7CaUP9yABZIpTI5I8stSSWiFBZwaxlabNS0R-VajPEOMF5vEMdQD7ZTjhy8roohnIL40CkGDhSg_72Sj7Vvg/s1600/8525364-an-image-of-a-dirty-microwave-oven.jpg" height="200" width="155" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">(3.47e min. de la vidéo)</span> ? <span style="font-family: "Trebuchet MS",sans-serif;">Pensez-vous qu'un utilisateur normalement constitué aurait envie de mettre son frichti à l'extérieur de l'appareil ?</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;">Pourquoi alors rappeler à l'utilisateur ce qu'il sait déjà ? Est-ce vraiment l'essentiel du métier de rédacteur technique ?..</span>.<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;"> </span></b></span></span></span></span><br />
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">________________________________</span></b></span></span></span></span><br />
<h3>
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;">Remettre en question l'intelligence de l'utilisateur ?</span></span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">Arrêtez-vous (4.13e minute) sur l'instruction lue par Dany Boon : </span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"><i>"Pour mettre en route le micro-onde, appuyez sur la touche Start" </i></span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">N</span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">ous sommes d'accord, seul un Ch'ti pouvait commenter -en aparté, soit- <i>"On n'est pas des c..."</i> Mais est-ce vraiment nécessaire de noircir du papier pour asséner une telle évidence ? </span></span><br />
<br />
<div class="separator" style="clear: both; text-align: left;">
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">A ce sujet, observez un bout de chou de 3 ou 4 ans à qui l'on vient de </span></span><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhZ8ABkYjeE-zkeEqKxx8q1QhfcC135PHeI3W6hiHXRPDvYvzkZ3YNUlB9SHI5WpDNAZn8jszg6jxwiFzYvCcAHdYtmezMuoBMc2_1DuxQpH0CE8vRkKa6WJ6D09rOWM6TTfsaqkMdh-zE/s1600/stupid_shirt.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhZ8ABkYjeE-zkeEqKxx8q1QhfcC135PHeI3W6hiHXRPDvYvzkZ3YNUlB9SHI5WpDNAZn8jszg6jxwiFzYvCcAHdYtmezMuoBMc2_1DuxQpH0CE8vRkKa6WJ6D09rOWM6TTfsaqkMdh-zE/s1600/stupid_shirt.jpg" height="199" width="200" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">montrer comment écouter ad libitum sa ritournelle préférée sur une tablette. Il ne sait ni lire ni écrire, mais il fait le lien entre le bouton START et le plaisir de l'écoute... sans bien entendu savoir qu'il s'agit d'un bouton START et sans manuel utilisateur !</span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">Appliquons donc un des principes du minimalisme : respectons le savoir-faire de l'utilisateur, ne nous moquons pas de lui !</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"></span></span>
<h3>
</h3>
<h3>
<span style="font-weight: normal;"><span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><b><span style="color: #38761d;">_________________________________________________</span></b></span></span></span></span></h3>
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">Fonctions, multifonctions et fonctionnalités</span></span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">Si, un jour de grand désespoir, vous étiez tenté de démarrer un chapitre <b>"Les multifonctions"</b> , n'hésitez pas à écouter le passage idoine de la vidéo. Cela risque peut-être de doucher quelques ardeurs malvenues...<br /><br /><span style="font-size: small;"><span style="color: #660000;">Que faire alors des "Multifonctions" ?</span></span><br />En minimalisme, on ne parle <b>JAMAIS de fonctions</b>, mais <b>TOUJOURS de l'ACTION</b> que doit effectuer l'utilisateur pour accomplir une tâche (et ainsi atteindre son objectif).<br />On ne parlera pas de la "Multifonction décongélation programmable", mais de "<b>Programmer la décongélation des aliments".</b></span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"></span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"><span style="color: #660000;">Conclusion ?</span></span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"> Vous avez raison, il faudrait inviter Dany Boon à présider le prochain <a href="http://www.conseil-des-redacteurs-techniques.fr/">congrès des rédacteurs techniques !</a> Il a tout compris ... </span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-weight: normal;">(*) Qu'est-ce <a href="http://fr.wikipedia.org/wiki/Picard#Origine_du_mot_ch.27ti">qu'un Ch'ti ? </a></span></span><br />
<h3>
</h3>
Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-49424702013112202542013-12-26T09:22:00.002+01:002014-01-06T11:15:47.212+01:00<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhZ2DYkYIa0l5j4GwuGFSL8gKfhhqYYf6wQOPDZq-7s53HB1CzJbqa5_Cm_v7oYSuDqCGPVFuH9BJ1_j4jcv6uKT0FKuryFwcT5ujfib_btMG3PDNyeDxLPBIy3tKamMSIDBaJcEG4qa5s/s1600/Qualtiy_Tampon.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhZ2DYkYIa0l5j4GwuGFSL8gKfhhqYYf6wQOPDZq-7s53HB1CzJbqa5_Cm_v7oYSuDqCGPVFuH9BJ1_j4jcv6uKT0FKuryFwcT5ujfib_btMG3PDNyeDxLPBIy3tKamMSIDBaJcEG4qa5s/s1600/Qualtiy_Tampon.jpg" /></a></div>
<h2>
<span style="color: #660000;"><span style="font-size: x-large;">Ma documentation est de qualité ! </span></span></h2>
<br />
<h3>
<span style="font-family: Verdana,sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Nul doute, puisque vous y avez apporté toute l'attention et les compétences nécessaires.</span></span></h3>
<span style="font-family: Verdana,sans-serif;"><span style="font-family: "Trebuchet MS",sans-serif;">Par exemple, le formatage, la mise en page, le choix des caractères, l'outil d'aide à la rédaction, le correcteur orthographique (non, vous êtes au point et n'en avez pas besoin...), les notes des développeurs, le logiciel de capture d'écrans, l'outil de création graphique, etc. <br /><br />Vous avez constitué votre équipe de rédaction et lui avez fourni un planning ? Bravo !</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjHetRnbRk8RyfPY9PkapVWshbO-oHXirTw9WlMVr9254WU9DABEUowZKNGU8RhLNDb2L4oz2AZTsmuoyaA8erkR3sUXNBB2x17vEF54KQ0wVAmSjhwv8PSRCnQrDVEt4RT2f32cfth4Dg/s1600/DocumentationTeam.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjHetRnbRk8RyfPY9PkapVWshbO-oHXirTw9WlMVr9254WU9DABEUowZKNGU8RhLNDb2L4oz2AZTsmuoyaA8erkR3sUXNBB2x17vEF54KQ0wVAmSjhwv8PSRCnQrDVEt4RT2f32cfth4Dg/s1600/DocumentationTeam.jpg" /></a></div>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Votre Dream Team a travaillé d'arrache-pied en se délectant des nouvelles fonctionnalités du logiciel de mise en page.</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Last but not least: vous avez faire relire l'ensemble du manuel par un <a href="http://www.onisep.fr/Ressources/Univers-Metier/Metiers/correcteur-trice">"éditeur"</a>. </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;">Tout est prêt pour la publication ? Champagne !...</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<h4>
<span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;">Comment mesurer la qualité</span></span></span></h4>
<span style="font-family: "Trebuchet MS",sans-serif;">En réalité,</span> l<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: large;"><span style="font-size: small;">a qualité ne se mesure pas exclusivement à la mise en page, évaluée par un membre de l'équipe de rédaction, mais sur des <a href="http://www.cndp.fr/savoirscdi/cdi-outil-pedagogique/apprentissage-et-construction-des-savoirs/maitrise-de-linformation/etude-et-travaux-de-recherche/lecture-et-comprehension-des-documents-proceduraux.html">critères d'utilisabilité</a>... effectués par l'utilisateur final !</span></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjBN1zWUmPpcqrj0r3Lw3W2BAaCco8nF9tEw0RAOLLJPnBic-dSuwnSlUzgM4kI1VSK62kBLxdj9qZRKvhV1O-ETSOEbOpDOUVhQJRma7ztnVDsCo2N3Avxo4au354Z-ZKH-kTdDnB6alY/s1600/BetterManualNeeded.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjBN1zWUmPpcqrj0r3Lw3W2BAaCco8nF9tEw0RAOLLJPnBic-dSuwnSlUzgM4kI1VSK62kBLxdj9qZRKvhV1O-ETSOEbOpDOUVhQJRma7ztnVDsCo2N3Avxo4au354Z-ZKH-kTdDnB6alY/s400/BetterManualNeeded.jpg" height="80" width="400" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<span style="font-family: "Trebuchet MS",sans-serif;">Patatras ! L'utilisateur n'aime pas votre manuel... il ne peut pas s'en servir ; il ne lui sert à rien.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">Vous avez investi 2 mois de travail pour 3 personnes et une semaine de révision qui se terminent par un rejet manifeste de la part du destinataire du manuel. Pas très brillant, n'est-ce pas ? Peut-on encore parler de qualité ?</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><br /></span>
<br />
<h3>
<span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif;">Que vient faire le minimaliste dans ce scénario ?</span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Le <a href="http://www.infomanagementcenter.com/Resources/eNews2012-12JHackos.pdf">minimalisme</a> consiste à ne donner à l'utilisateur que l'information dont il a besoin pour accomplir une tâche. C'est à dire par exemple lui <u>faciliter l'accès à l'information </u>(principe n° 4).</span><br />
<br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Comment trouver rapidement l'information dont on a besoin ?</span><span style="font-family: "Trebuchet MS",sans-serif;"> </span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;">A ce stade, le point crucial est la <b>"</b><u>Navigation</u><b>" </b>:</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span>
<br />
<blockquote class="tr_bq">
<i><span style="font-family: "Trebuchet MS",sans-serif;">"This category highlights those aspects of a document that facilitate a reader’s ability to find relevant information. Is a logically grouped, easy-to-navigate table of contents provided, for accessing particular information?"</span></i></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;">C'est pour cela que l'on fournira une <u>table des matières</u>, un <u>index</u>, mais aussi une rédaction</span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-family: "Trebuchet MS",sans-serif;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgIpbqFaem5aK7ukGV7iggOl7WS2ueSWhkaalxBRUCGG41mpAwvNS0LtxhMD0wuOLx777mRr2zyALw6_WAes8COozoEJLTmgFELs9_2O9euLHQgtIlABTGNPrT20bKAkeRKDsy0kAfgi0k/s1600/ThickManual_HairTrimmer.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgIpbqFaem5aK7ukGV7iggOl7WS2ueSWhkaalxBRUCGG41mpAwvNS0LtxhMD0wuOLx777mRr2zyALw6_WAes8COozoEJLTmgFELs9_2O9euLHQgtIlABTGNPrT20bKAkeRKDsy0kAfgi0k/s400/ThickManual_HairTrimmer.jpg" height="285" width="400" /></a></span></div>
<span style="font-family: "Trebuchet MS",sans-serif;"> par <u>rubriques</u> (les fameux <a href="http://dita.xml.org/book/writing-dita-topics">"Topics"</a> sous DITA). Il n'est plus question de rédaction "waterfall" ou au fil de l'eau (Proust, James Joyce, Zola ne sont pas rédacteurs techniques...), mais de courtes procédures, très bien libellées et indépendantes.</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Très bien libellées, cela signifie que le <u>titre</u> de votre rubrique doit être précis, "parlant" et correspondre à la terminologie de l'utilisateur.</span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"></span><br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Savoir naviguer et savoir éliminer !</span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Pour pouvoir naviguer, il faut permettre la circulation et donc éliminer les <a href="http://fr.wikipedia.org/wiki/Bois_flott%C3%A9">"bois flottés" </a>qui entravent la recherche rapide.</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Dans cet article "Tips and Tricks: <a href="http://techwhirl.com/tips-and-tricks-10-heuristics-documentation-usability/">10 Heuristics for Evaluating Documentation Usability"</a></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;">on nous rappelle l'essentiel, c'est-à-dire élaguer et ôter ce qui n'est pas pertinent : </span><br />
<blockquote class="tr_bq">
<i><span style="font-family: "Trebuchet MS",sans-serif;"> "8. Minimalist writing</span></i><br />
<i><span style="font-family: "Trebuchet MS",sans-serif;"></span></i>
<i><span style="font-family: "Trebuchet MS",sans-serif;">Topics should avoid information that is irrelevant. Every extra unit of information in a topic competes with the relevant information, which diminishes the findability of relevant information."</span></i></blockquote>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhnCw7weyS9sR9umSstVvYFW1JDqr9i0Vj5cVMWHLNVkKfPDRWXar_7H7-T9tWDN71OOz1i_kPmLSPq5DWQBIa2zT7L_sQtWNB74J2RTbkDI89cVGBdkNfI-RC-K5xGHUlWob4kHAjEyxs/s1600/DrownInformation.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhnCw7weyS9sR9umSstVvYFW1JDqr9i0Vj5cVMWHLNVkKfPDRWXar_7H7-T9tWDN71OOz1i_kPmLSPq5DWQBIa2zT7L_sQtWNB74J2RTbkDI89cVGBdkNfI-RC-K5xGHUlWob4kHAjEyxs/s1600/DrownInformation.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;">Effectivement, non seulement il est essentiel de travailler en (petites) rubriques , mais il est capital de ne pas NOYER l'information pertinente dans un marigot de bla-bla superflu.</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">C'est ce que nous démontre, très à propos, <a href="http://www.customercarewords.com/about-gerry.html">Gerry McGovern </a>dans son article "<a href="http://www.infomanagementcenter.com/members/pdfs/reprints/08012013.htm">From managing inputs to managing outcomes" :</a></span><br />
<br />
<blockquote class="tr_bq">
<i><span style="font-family: "Trebuchet MS",sans-serif;">Customers want to know more in order to make better decisions. But the information must be easy to find and easy to understand." </span></i></blockquote>
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Pour être de qualité, l'information doit être facilement accessible et compréhensible... pas uniquement bien emballée !</span><br />
<br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Utile, efficace et sans paroles ?</span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;">Last but not least, voici un exemple patent d'une information utile, efficace et d'accès aisé. Il s'agit d'une <a href="http://www.blogger.com/Wordless%20Assembly%20instructions:%20is%20the%20paper%20manual%20obsolete?%20#mobileapp%20#SAP%20http://www.youtube.com/watch?v=uPCMmJ7BrRo">video expliquant le montage d'un lit d'enfant.</a> Aucun avertissement ("attention, l'utilisation d'un tournevis peut être dangeureuse !"), aucune note ("Le montage du lit doit être effectué par un professionnel dûment formé"), aucune "consigne de sécurité à lire absolument"... les instructions sont là, disponibles après 1 ou 2 clics et sans paroles !</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;">Pour l'équipe de rédaction, il n'est plus question de taille de caractères, d'avant-propos, ni de traduction... puisque la video est sans paroles. Et pourtant, l'utilisateur trouve facilement l'information dont il a besoin pour monter le lit. </span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com2tag:blogger.com,1999:blog-4470063915169982637.post-28614256765978303762013-10-11T10:27:00.000+02:002014-06-05T18:24:57.069+02:00Documentation médicale:l'infobesity,ça se soigne, Docteur ?<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Dans le secteur de la santé, on connaît l'importance de la documentation. C'est pour cela qu'on fournit des manuels de 500 pages destinés au personnel médical !</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br />Les équipes de soins ont -surtout dans les hôpitaux français- le temps de s'arrêter, une </span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjCD1PoJhT578e5iV8vTS54-wQoVbn0jwxTu_5u180v_FDWTeeD_f3LLpnLm0s0UfewZzbC4-DNxh6XksXQfXXG8ViEwyKS6DnwphThOZn0EschQhgFLw3Ds-1inKy4TQ1sNBkD6dGCFzc/s1600/Medical_book.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjCD1PoJhT578e5iV8vTS54-wQoVbn0jwxTu_5u180v_FDWTeeD_f3LLpnLm0s0UfewZzbC4-DNxh6XksXQfXXG8ViEwyKS6DnwphThOZn0EschQhgFLw3Ds-1inKy4TQ1sNBkD6dGCFzc/s200/Medical_book.jpg" height="200" width="200" /></a></span></div>
<span style="font-family: Trebuchet MS, sans-serif; font-size: small;">tasse de café à la main, pour lire 3 chapitres du guide utilisateur...</span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Et si, au lieu de leur fournir une <span style="color: #0b5394;">documentation inexploitable</span>, on cessait de dégurgiter du texte pour le plaisir (le nôtre, pas le leur...) ?</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<br />
<h2>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">Evitons l'infobesity !</span></span></h2>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Selon Dr. JoAnn Hackos :</span></span><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> </span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> <i>"In fact, the shorter and more lean the text, the more likely it will be read"</i></span></span><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">En clair, en documentation : ce n'est pas parce que c'est long que c'est bon !</span></span><br />
<br />
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">Eliminer, dégraisser... c'est possible !</span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Eliminer ce qui ne sert qu'à agacer l'équipe médicale (elle a un patient à traiter et ne cherche pas, dans le manuel, <span style="color: #073763;">ce qu'elle sait déjà</span>), comme par exemple :</span></span><br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEioGKpN9KOC76JTmPhP3vs38TjXGJNfMQIAeNoLNXpPaIOgTaOzV1vwjoDl43e3PsK1b8kScDdiZ7-wLxhhdSp3FhSQ1eskwIJzpoUJIhMf_IBNBBzBe3Ecaw36pVSFnqsqXUCeh4Dgpyk/s1600/GreenLed.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEioGKpN9KOC76JTmPhP3vs38TjXGJNfMQIAeNoLNXpPaIOgTaOzV1vwjoDl43e3PsK1b8kScDdiZ7-wLxhhdSp3FhSQ1eskwIJzpoUJIhMf_IBNBBzBe3Ecaw36pVSFnqsqXUCeh4Dgpyk/s320/GreenLed.jpg" height="58" width="320" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Mais bien sûr, le manipulateur radio a vécu ces 40 dernières années dans une grotte de Mongolie inférieure et ne sait pas qu'un voyant vert indique que l'appareil marche !</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br />De même, il n'est pas nécessaire d'expliquer, plusieurs fois, que pour sortir d'une application, il faut appuyer sur EXIT.</span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEisMrkYBVcUMsCPKhmxODgGz5nMI5rXWdwzSTKJSD5Zn12emQaOg_1ONnJOP7iG5tDNdpyt40jnJ2hJvyqFCr0LJjaJ704HbyqbS3mFlTaD-tOPzRABaec7p-Z2rufiMSd9yONDMBOHu7U/s1600/Exiting_Medical_Condensed.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEisMrkYBVcUMsCPKhmxODgGz5nMI5rXWdwzSTKJSD5Zn12emQaOg_1ONnJOP7iG5tDNdpyt40jnJ2hJvyqFCr0LJjaJ704HbyqbS3mFlTaD-tOPzRABaec7p-Z2rufiMSd9yONDMBOHu7U/s320/Exiting_Medical_Condensed.jpg" height="191" width="320" /></a></span></div>
<br />
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: large;">Tout est bon à mettre dans la documentation !</span><br />
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">A trop vouloir tout dire, l'utile et le futile, certains rédacteurs se prennent les pieds dans le tapis.</span></span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> Ainsi, le mode d'emploi d'un défibrillateur précise, dès la page 5, qu'il faut aller vite :</span></span><i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> </span></span></i><br />
<i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> "... les taux de survie liés aux arrêts cardiaques...sont directement liés à la rapidité d'intervention... Chaque minute de délai entraîne une diminution des chances de survie d'environ 10 %"</span></span></i><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Bien vu, mais alors pourquoi fournir à l'utilisateur un <span style="color: #0b5394;">manuel de 108 pages</span> si l'on n'a que quelques minutes pour sauver une vie ?</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<br />
<h2>
<span style="color: #990000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">Sur-irradié à cause du manuel... en anglais !</span></span></h2>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Au lieu de se concentrer sur le superflu et l'inutile, il est préférable -en matière de matériel médical- de s'impliquer dans la traduction des documentations dans la langue de l'utilisateur. Cela évitera de <a href="http://www.la-croix.com/Actualite/France/La-longue-quete-de-verite-des-irradies-d-Epinal-_EP_-2012-09-24-856614">graves accidents</a>.<br /> </span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgX-GRK7kb056fXDYpUUZqw7eu8Xv1thyphenhyphenPgMvN9sZlrBtwrp2kVTwwa1RbJwr19Bgw2_wc6R04JgwUnFwdvBLAqytyOdk66an0NYF9Ltf-hUlGP6UQ9mqzLFwcYyiBXqS96Qsvoci1AFOk/s1600/header-medical-device-eval.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgX-GRK7kb056fXDYpUUZqw7eu8Xv1thyphenhyphenPgMvN9sZlrBtwrp2kVTwwa1RbJwr19Bgw2_wc6R04JgwUnFwdvBLAqytyOdk66an0NYF9Ltf-hUlGP6UQ9mqzLFwcYyiBXqS96Qsvoci1AFOk/s320/header-medical-device-eval.jpg" height="146" width="320" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Il a donc fallu plusieurs décès et des centaines de personnes mutilées pour que les autorités sanitaires rappellent aux fabricants leur obligations. </span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br />Dans sa note d'août 2007, l'AFSSAPS rappelle dans son "AVIS AUX FABRICANTS DE DISPOSITIFS MEDICAUX DE RADIOTHERAPIE" , l'article R. 5211-20 du Code de la Santé Publique qui stipule que la notice qui accompagne le dispositif médical et toute information relative à son fonctionnement doit comporter une <span style="color: #0b5394;">version rédigée en français.</span><br /><br />Il était temps... puisqu'un autre <a href="http://www.europe1.fr/Politique/145-nouveaux-cas-d-irradiation-a-Toulouse-26807/">problème de sur-irradiation </a>faisait ressortir que</span></span><br />
<i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> </span></span><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjPrArMsXOk7lFB4GoAhf1NJSLNYzjYqMuoTK1Hy6ghb0OjdgKmTUjMLEH_JTwZG_qrnimULFz2zjsegnwObHPCUQf5NOVQ5aEiA4E6POGUx3HU2DrX5jLufasN78y9NOU0SW2Gxla9e00/s1600/TeaPot.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjPrArMsXOk7lFB4GoAhf1NJSLNYzjYqMuoTK1Hy6ghb0OjdgKmTUjMLEH_JTwZG_qrnimULFz2zjsegnwObHPCUQf5NOVQ5aEiA4E6POGUx3HU2DrX5jLufasN78y9NOU0SW2Gxla9e00/s1600/TeaPot.jpg" /><span style="font-size: small;"> </span></a></i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><i> " Les appareils avaient été là aussi mal réglés car le manuel d'utilisation était en anglais.</i> "</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"></span></span><br />
<span style="color: #660000; font-family: 'Trebuchet MS', sans-serif; font-size: large;">La norme et ses contraintes </span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Trop souvent, le rédacteur oublie de penser d'abord à son utilisateur. Il préfère suivre aveuglément la norme.</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Ainsi, la norme <a href="http://webstore.iec.ch/preview/info_iec62083%7Bed2.0%7Db.pdf">IEC 62 083</a> indique, dans son annexe A :</span></span><i><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"> "Les INSTRUCTIONS D'UTILISATION et la description technique doivent contenir toutes les informations nécessaires pour effectuer sans risque: les opérations ... d'installation, d'utilisation et de maintenance du matériel..."</span></span></i><br />
<blockquote class="tr_bq">
<span style="font-family: "Trebuchet MS",sans-serif;"></span></blockquote>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Le rédacteur distrait composera donc un beau, gros manuel -499 pages seulement- incluant une<b> Introduction</b>, un <b>A propos de</b>... (ou Aperçu), une section<b> Généralités</b> (dans laquelle il noiera une information capitale) puis une section <b>Installation</b> (surtout si le matériel est volumineux et très compliqué), suivie d'une section "<b>Consignes de sécurité</b>" (24 pages d'avertissements). Il abordera alors la partie "<b>Utilisation</b>". On sera alors à la page 189.</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">A ce stade, il s'apercevra qu'il manque une section "<b>A propos de ce manuel"</b> dans laquelle il décrira les conventions typographiques, les icônes et autres futilités.</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Lorsque le manuel aura atteint la page 250, le rédacteur formé au minimalisme lui expliquera que tout cela est INUTILE et que l'utilisateur a besoin de trouver, dans <span style="color: #0b5394;">la minute qui suit</span>, une <span style="color: #0b5394;">information précise</span> sur la mise à zéro des données du patient avant traitement... <b>C'EST TOUT !</b></span></span><br />
<br />
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">Et la norme ?</span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">C'est exactement ce que dit la norme : fournir les "<i>informations nécessaires pour effectuer sans risque les opérations d'utilisation du matériel".</i></span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhC3u1p_hmt51djImNcvmVMCsLOn3hKCnlSqjcb3OPhohWxsIG6w512dQ2PQ5Nl4pDh9yx0HS2xdFifGLBdZUAXxZwtasg3m1QBEOf5VgtKqOn-JhHaZXMPgd3VTVFxZlvZa3epFmIuNM4/s1600/Doctor_Stylise.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhC3u1p_hmt51djImNcvmVMCsLOn3hKCnlSqjcb3OPhohWxsIG6w512dQ2PQ5Nl4pDh9yx0HS2xdFifGLBdZUAXxZwtasg3m1QBEOf5VgtKqOn-JhHaZXMPgd3VTVFxZlvZa3epFmIuNM4/s1600/Doctor_Stylise.jpg" /></a></div>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">La documentation ne doit contenir que ce dont l'utilisateur a besoin ; un médecin n'a pas besoin des <span style="color: #0b5394;">guides d'installation </span>(parce que c'est le fabricant qui procède à l'installation) ni du <span style="color: #0b5394;">guide de maintenance</span> (le fabricant doit s'en charger). Ou alors voulez-vous vraiment que le médecin revienne le dimanche s'occuper de la maintenance de son scanner ?</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">C'est pourquoi le rédacteur qui met en avant les besoins de son utilisateur créera <span style="color: #073763;">SEPAREMENT</span> :</span></span><br />
<ul>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">un <span style="color: #0b5394;">manuel d'installation </span>(destiné au représentant du fabricant chargé de l'installation) </span></span></li>
<li><span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">un <span style="color: #0b5394;">manuel de maintenance</span> pour le technicien qui vient régulièrement vérifier les paramétrages et l'usure du matériel.</span></span></li>
</ul>
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">La bonne blague espagnole </span></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Ne manquons pas cette petite histoire de documentation pharmaceutique inadaptée... celle des notices diffusées en<a href="http://www.mhra.gov.uk/home/groups/pl-p/documents/drugsafetymessage/con309645.pdf"> espagnol pour le personnel médical anglophone</a> (et en </span></span><br />
<div class="separator" style="clear: both; text-align: center;">
<span style="font-size: small;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj_AWn1Bj1IZq_QSl0Z0jBqupSAf2p6-EpNr9AZIFpLNLoizdzED_ev_XFRBTuGD5HaATEkc8ZbqkD0VHD3zlSOLFAHRY5u5FFwBmsxurfm3nM8RPRadoTqj-APEVG0Ud5j_D8yfuylY4c/s1600/Spanish.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj_AWn1Bj1IZq_QSl0Z0jBqupSAf2p6-EpNr9AZIFpLNLoizdzED_ev_XFRBTuGD5HaATEkc8ZbqkD0VHD3zlSOLFAHRY5u5FFwBmsxurfm3nM8RPRadoTqj-APEVG0Ud5j_D8yfuylY4c/s1600/Spanish.jpg" /></a></span></div>
<span style="font-family: Trebuchet MS, sans-serif; font-size: small;">Grande-Bretagne).<br /><br />Comme le fabricant n'avait plus de notices en anglais, il a envoyé les notices en espagnol ! </span><br />
<br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Il faut juste espérer que les hôpitaux britanniques avaient assez d'infirmières espagnoles à disposition !</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">C'est certainement une nouvelle version de ce que l'on appelle "<a href="http://fr.wiktionary.org/wiki/parler_fran%C3%A7ais_comme_une_vache_espagnole">parler anglais comme une vache espagnole </a>"</span></span><br />
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;"><br /></span></span>
<br />
<h3>
<span style="color: #660000;"><span style="font-family: "Trebuchet MS",sans-serif; font-size: large;">Minimalisme appliqué à la documentation médicale</span></span></h3>
<h3>
<span style="font-family: "Trebuchet MS",sans-serif;"></span></h3>
<span style="font-family: "Trebuchet MS",sans-serif;"><span style="font-size: small;">Pour un exemple de mise en place des principes du<a href="http://tinyurl.com/q3c5ttx"> minimalisme pour la documentation médicale</a>, vous pouvez suivre cette présentation faite à la <span style="color: #0b5394;">Scientific Conference on Strategic Development and Performance in Healthcare Institutions </span>en janvier 2013.</span></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0tag:blogger.com,1999:blog-4470063915169982637.post-55101189056371427122013-10-02T16:29:00.000+02:002014-05-26T14:42:23.954+02:00Aéronautique & documentation minimaliste : go or no go ?<span style="font-family: Verdana,sans-serif;">Dans le nucléaire, on peut appliquer sans hésitation les <a href="http://minimalist-doc.blogspot.fr/2013/09/documentation-minimaliste-pas-dans-le.html">règles de la documentation minimaliste.</a></span><br />
<h2>
<span style="font-size: x-large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: Verdana,sans-serif;">Soit, mais pas dans l'aéronautique, sacrebleu !</span></span></span></span></h2>
<h3>
<span style="font-family: Verdana,sans-serif;"></span></h3>
<span style="font-family: Verdana,sans-serif;"></span><br />
<h3>
<span style="font-family: Verdana,sans-serif;">Pas besoin de minimalisme ? C'est à voir...</span></h3>
<span style="font-family: Verdana,sans-serif;">Ainsi, en 2005, AIR FRANCE, dans sa démarche pour "<i>simplifier les procédures des équipages</i>" a fait une refonte du "manuel d'exploitation" ... qui a été "<i>complété, 3 semaines plus tard par <u>deux cent cinquante-cinq (255) </u>pages de mise à jour et de corrections</i>"...</span><span style="font-size: small;"><span style="font-family: Verdana,sans-serif;"> </span></span><br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEidvKisnwKsqVli9HGgkZ0zCVdXZmbofURckn7d0oUUb1d9xLk9Uu7g5SQnj89S6uHF73ek_gf0qRGUsvRdGOEQah-yE2y-_X4QW8uMWjw0nZuyRQOYtbljbZdu8eYU71dtqaOZ6Z7dxKQ/s1600/cross-windLanding.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEidvKisnwKsqVli9HGgkZ0zCVdXZmbofURckn7d0oUUb1d9xLk9Uu7g5SQnj89S6uHF73ek_gf0qRGUsvRdGOEQah-yE2y-_X4QW8uMWjw0nZuyRQOYtbljbZdu8eYU71dtqaOZ6Z7dxKQ/s1600/cross-windLanding.jpg" /></a></div>
M<span style="font-size: small;"><span style="font-family: Verdana,sans-serif;">ais ce n'était pas du goût du porte-parole du Syndicat national des pilotes de ligne :</span></span><i><span style="font-family: Verdana,sans-serif;"> </span></i><br />
<br />
<i><span style="font-family: Verdana,sans-serif;">"Quand vous avez une documentation pléthorique, des dizaines de pages superflues, les pilotes ne peuvent pas se reconnaître dans ce qui doit être le socle d'une culture commune"(*)</span></i><br />
<br />
<span style="font-family: Verdana,sans-serif;"></span><span style="font-family: Verdana,sans-serif;">C'est là le coeur de la démarche minimaliste : ne donnez à l'utilisateur que l'information dont il a besoin. Pourquoi lui fournir une documentation <b>volumineuse</b> si elle n'est <b>pas exploitable</b> ? </span><br />
<span style="font-family: Verdana,sans-serif;"> </span><span style="color: #990000;"><span style="font-weight: normal;"><span style="font-family: Verdana,sans-serif;"> </span></span></span><br />
<h2>
<span style="font-size: x-large;"><span style="color: #990000;"><span style="font-weight: normal;"><span style="font-family: Verdana,sans-serif;">Du volume, sinon rien !</span></span></span></span></h2>
<h4>
<span style="font-family: Verdana,sans-serif;"></span></h4>
<span style="font-family: Verdana,sans-serif;">Ce même phénomène est relevé dans le rapport d'accident du vol TAM à l'atterrissage sur l'aéroport de Sao Paolo : </span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Verdana,sans-serif;">"The A-320 manuals have lots of pages and are hard to consult,mainly during the flight"</span></i><br />
<span style="font-family: Verdana,sans-serif;"></span></blockquote>
<span style="font-family: Verdana,sans-serif;">Effectivement, ce n'est pas le volume de la documentation qui la rend utile, mais son <u>accessibilité</u>. Est-il facile d'obtenir l'information sur les "reversers" lorsqu'ils ne fonctionnent plus ? Combien de pages et de chapitres<br />feuilleter avant d'avoir exactement la procédure de secours ?<br /><br /> </span><br />
<span style="font-family: Verdana,sans-serif;">Très, très significatif également, le rapport d'accident du vol 1549 qui, après </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiCQ5T_-Y5wC-Q_HUrOxLdEtgvkIjf_hxE1yiLicS38a2MET85AZTradB24q-r5voow8DdI-xEtcVb-yT71kDSA-ankwuz4fr9RcHtBDYNPoNUSyFF8c3IDhlbmSNPpwvXgc64gwJODMYI/s1600/HudsonRiver.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiCQ5T_-Y5wC-Q_HUrOxLdEtgvkIjf_hxE1yiLicS38a2MET85AZTradB24q-r5voow8DdI-xEtcVb-yT71kDSA-ankwuz4fr9RcHtBDYNPoNUSyFF8c3IDhlbmSNPpwvXgc64gwJODMYI/s1600/HudsonRiver.jpg" /></a></div>
décollage de La Guardia, a dû amerrir dans la <a href="http://www.youtube.com/watch?v=E8itHvXd0oM">baie de l'Hudson</a>. <br />
<br />
<span style="font-family: Verdana,sans-serif;">L'excellent capitaine Sullenberger a suivi les procédures et, en duo avec le co-pilote, a pointé la "check-list".</span><br />
<span style="font-family: Verdana,sans-serif;"><br /></span>
<span style="font-family: Verdana,sans-serif;">Toutefois, heureusement qu'il ne soit pas allé jusqu'au bout des<a href="http://www.skybrary.aero/index.php/A320,_vicinity_LaGuardia_New_York_USA,_2009_%28BS_LOC_AW%29"> listes de pointage,</a> parce qu'il aurait terminé sa course au fond de l'Hudson :</span><br />
<span style="font-family: Verdana,sans-serif;"></span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Verdana,sans-serif;">"However, according to post-accident interviews and CVR data, the flight crew did not complete this Checklist, which had 3 parts and was 3 pages long; although they were able to complete most of part 1, lack of time precluded starting Parts 2 and 3."</span></i><br />
<span style="font-family: Verdana,sans-serif;"></span></blockquote>
<span style="font-family: Verdana,sans-serif;">C'est là un des points-clés d'une formation au minimalisme : est-ce que la documentation est utile à l'utilisateur <b>dans son environnement de travail ?</b></span><br />
<br />
<span style="font-family: Verdana,sans-serif;">C'est ce que Dr. Hans van der Meij appelle<b> "</b><a href="http://users.edte.utwente.nl/meij/anchoring.htm">Anchor the tool in the task domain</a>". </span><br />
<span style="font-family: Verdana,sans-serif;"><br /></span>
<br />
<h2>
<span style="font-size: x-large;"><span style="font-family: Verdana,sans-serif;"></span><span style="color: #990000;"><span style="font-weight: normal;"><span style="font-family: Verdana,sans-serif;">Terminologie ? un gadget négligeable !</span></span></span></span></h2>
<span style="font-family: Verdana,sans-serif;"> La terminologie... quantité négligeable aux yeux de certains.</span><br />
<br />
<span style="font-family: Verdana,sans-serif;">En s'arrêtant sur la liste des rapports d'accidents et incidents publiée sur le </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiKSQyF_wt9qYJLHGx1mETAosIhJkmIsSOCXpGcRsdzqKVeV9y_-FeGE5_PD1At9RgKccaDbxCIFjGPvu6NTrFi74R8ju3-wfAiwvn-8eCIqxWMIU_eX7WLbQre_1XEu4tz65kKT_JCsUU/s1600/HamburgAirport.jpg" imageanchor="1" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiKSQyF_wt9qYJLHGx1mETAosIhJkmIsSOCXpGcRsdzqKVeV9y_-FeGE5_PD1At9RgKccaDbxCIFjGPvu6NTrFi74R8ju3-wfAiwvn-8eCIqxWMIU_eX7WLbQre_1XEu4tz65kKT_JCsUU/s1600/HamburgAirport.jpg" /></a></div>
site de SkyBrary (initiative EUROCONTROL), on découvre, dans le rapport d'accident sur<a href="https://www.youtube.com/watch?v=c13gU9pBuFg"> l'aéroport de Hambourg,</a> un sérieux manquement en terminologie :<br />
<br />
<blockquote class="tr_bq">
<i><span style="font-family: Verdana,sans-serif;"> "The terminology maximum crosswind demonstrated for landing was not defined in the Operating Manual and in the Flight Crew Operating Manual, and the description given was misleading“</span></i><br />
<span style="font-family: Verdana,sans-serif;"></span></blockquote>
<span style="font-family: Verdana,sans-serif;">Il semblerait que l'équipe de documentation ait oublié, ici, que la terminologie doit être CONSTANTE et COHERENTE !</span><br />
<span style="font-family: Verdana,sans-serif;"><br /></span>
<br />
<h2>
<span style="font-size: x-large;"><span style="font-weight: normal;"><span style="color: #990000;"><span style="font-family: Verdana,sans-serif;">Procédures ?... vous avez dit procédures ?</span></span></span></span></h2>
<span style="font-family: Verdana,sans-serif;">Non seulement les pilotes, mais les ATC (contrôleurs aériens) sont confrontés à une documentation défaillante. </span><br />
<br />
<span style="font-family: Verdana,sans-serif;">Ainsi, suite à un incident grave sur l'<a href="http://www.skybrary.aero/index.php/A320/A320,_Zurich_Switzerland,_2011_%28LOS_HF%29">aéroport de Zurich-Kloten</a>, les enquêteurs découvrent avec horreur que :</span><br />
<span style="font-family: Verdana,sans-serif;"></span><br />
<blockquote class="tr_bq">
<i><span style="font-family: Verdana,sans-serif;">"the Zurich procedures contained no detailed description of how to manage simultaneous use of runways 16 and 28 for departures."</span></i></blockquote>
<blockquote>
<i><span style="font-family: Verdana,sans-serif;"></span></i><span style="font-family: Verdana,sans-serif;"></span></blockquote>
<span style="font-family: Verdana,sans-serif;">Le Bureau Fédéral de l'Aviation Civile Helvétique recommande donc que :</span><br />
<span style="font-family: Verdana,sans-serif;"></span><br />
<blockquote class="tr_bq">
<span style="font-family: Verdana,sans-serif;"><i>"the operator and users of Zurich airport should carry out a comprehensive analysis of the operating procedures and take all appropriate measures to reduce complexity and the systemic risks.</i>"</span></blockquote>
<span style="font-family: Verdana,sans-serif;"> Analyser les procédures pour suivre les actions à accomplir, analyser les </span><br />
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj0YHvp4Z4YVdVayIApvB2q_aL8tv2mQi8bunYnYzhwfU1xaUPSYQ8_h27E9HGn6ZKrsi1896ME6TG4JCMP-1aTpM_WTVu4R0omS8xJUl9A7efWT-VPanamCGTSdEHYWhzPtNZQK0lJgLI/s1600/NightAirport.jpg" imageanchor="1" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj0YHvp4Z4YVdVayIApvB2q_aL8tv2mQi8bunYnYzhwfU1xaUPSYQ8_h27E9HGn6ZKrsi1896ME6TG4JCMP-1aTpM_WTVu4R0omS8xJUl9A7efWT-VPanamCGTSdEHYWhzPtNZQK0lJgLI/s1600/NightAirport.jpg" /></a></div>
<span style="font-family: Trebuchet MS, sans-serif;">tâches de l'utilisateur et surtout mettre tout en oeuvre pour rendre le document clair et immédiatement utilisable, voilà les véritables mots d'ordre du rédacteur "minimaliste".</span><br />
<br />
<br />
<span style="font-family: Verdana,sans-serif;"><u>Produire de la documentation au kilomètre</u> n'est PAS du digne d'un bon rédacteur technique ; mettre toute son énergie pour fournir une <b>documentation exploitable, immédiatement utilisable et sans ambiguité</b> est la caractéristique du rédacteur formé au minimalisme, celui qui ne donne que l'information dont on a besoin !</span><br />
_____________________________<br />
(*) <span style="font-family: Verdana,sans-serif;"><span style="font-size: x-small;">Extrait de "La face cachée d'Air France", </span></span><br />
<span style="font-family: Verdana,sans-serif;"><span style="font-size: x-small;">p. 96--97, auteur : Fabrice Amedeo</span></span>Marie-L. Flackehttp://www.blogger.com/profile/11654763209947491977noreply@blogger.com0