{"id":1290,"date":"2015-03-03T15:30:11","date_gmt":"2015-03-03T20:30:11","guid":{"rendered":"http:\/\/samueldube.com\/demo\/lios\/choisir-support-documentation-technique\/"},"modified":"2019-02-18T15:42:54","modified_gmt":"2019-02-18T20:42:54","slug":"the-right-format-for-your-technical-documentation","status":"publish","type":"post","link":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/","title":{"rendered":"The Right Format for Your Technical Documentation"},"content":{"rendered":"<p>Are you thinking it\u2019s time to put your technical documentation into a new format? In this article, we\u2019ll go into the details of the formats most commonly used in technical documentation to help you choose the best one for your products and your clients.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-medium wp-image-1183\" src=\"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png\" alt=\"\" width=\"303\" height=\"280\" srcset=\"https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png 303w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-132x122.png 132w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-461x426.png 461w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10.png 600w\" sizes=\"auto, (max-width: 303px) 100vw, 303px\" \/><\/p>\n<h4>Paper<\/h4>\n<p>Ah! Good ol\u2019 paper! Printed documents never go out of style. After so many years, this classic format is still a good choice when you just want to hand a document to someone. It\u2019s easy to consult, inside or out, rain or shine. No batteries required: it\u2019ll work all the time, even when there\u2019s no network connections, no computers, no compatible outlets or CD trays. It\u2019s the ideal format for task support documents or warnings (health and safety guidelines, for instance). Printed documents may not be interactive, but readers can easily get friendly with paper, underlining important sections or adding notes in the margins. When a large volume of information needs to be shared, however, paper may not be your best bet since it\u2019s not very environmentally friendly.<\/p>\n<h4>Video<\/h4>\n<p>If an image is worth a thousand words, what is a video worth? Far more! In a video, you can show off your product\u2019s bells and whistles. Video is also a golden opportunity to demonstrate your product and your team\u2019s expertise by going into that extra detail, say, about its manufacturing quality or the best practice for using it. Video is also a good format when you want to promote new products or functionalities. Add a friendly, lively narrator and you\u2019ll put a human face on your company. This engaging format can help your clients get comfortable with your product and its procedures. Don\u2019t forget, though, that your viewer won\u2019t be able to easily retrieve information from a video. It\u2019s best to make several short films rather than a very long one. This will also keep your viewers attentive!<\/p>\n<h4>Screencasts<\/h4>\n<p>Screencasts are another interesting video format for documentation since they show what\u2019s on the computer screen. Narrated or silent, screencasts are often used in software tutorials. They are the go-to way many software experts show off their tips and tricks. Widespread on Youtube, this technique has gained popularity thanks to its simplicity and easy production. A computer and a mic\u2026 <i>voil\u00e0<\/i>! This said, most concepts and rules for producing video also apply to screencasts, so better do your homework before you start out. Since updating videos or adding new content can be tricky (filming, editing, etc.), make sure your video content will pass the test of time from the get-go..<\/p>\n<h4>Online<\/h4>\n<p>Dynamic and versatile, this format is ideal for just about every kind of documentation, from online support to training with everything in between. Quick access to a large volume of information, dynamic presentation (scroll-down menus, hyperlinks, interactivity, etc.), easy updating, fast searches and mobile accessibility are all very useful qualities of online format as well. Online documentation is perfect for brushing up on new skills, whether you want to learn the company collaboration tool or follow some e\u2011learning modules. It is also great for troubleshooting&#8230; unless you\u2019re having a network connection issue, of course! Some companies go beyond simple documentation by offering support via chat, while others share their software over cloud technology. And the best part in all this? You can mix and match all the formats and work them into your online documentation! Videos, screencasts, photos, PDF documents, PowerPoint or SlideShare presentations\u2026 the sky\u2019s the limit!<\/p>\n<h4>Go for it: find that format!<\/h4>\n<p>To make the most of their different advantages, maybe the best choice will be to divvy up your content into several formats! Regardless of your choice, don\u2019t forget to give the experts a call to make sure the quality of your documentation is top-notch.<\/p>\n<p>The following table summarizes the advantages of the various formats.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-2108\" src=\"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420.png\" alt=\"\" width=\"1024\" height=\"420\" srcset=\"https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420.png 1024w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420-168x69.png 168w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420-320x131.png 320w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420-768x315.png 768w, https:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/tableaucomparatif_ang-1024x420-580x238.png 580w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Are you thinking it\u2019s time to put your technical documentation into a new format? In this article, we\u2019ll go into the details of the formats most commonly used in technical documentation to help you choose the best one for your products and your clients. Paper Ah! Good ol\u2019 paper! Printed documents never go out of [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[40],"tags":[],"class_list":["post-1290","post","type-post","status-publish","format-standard","hentry","category-technical-communication-strategy"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>The Right Format for Your Technical Documentation - Lios<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The Right Format for Your Technical Documentation - Lios\" \/>\n<meta property=\"og:description\" content=\"Are you thinking it\u2019s time to put your technical documentation into a new format? In this article, we\u2019ll go into the details of the formats most commonly used in technical documentation to help you choose the best one for your products and your clients. Paper Ah! Good ol\u2019 paper! Printed documents never go out of [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/\" \/>\n<meta property=\"og:site_name\" content=\"Lios\" \/>\n<meta property=\"article:published_time\" content=\"2015-03-03T20:30:11+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-02-18T20:42:54+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png\" \/>\n<meta name=\"author\" content=\"Pascal\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Pascal\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/\"},\"author\":{\"name\":\"Pascal\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/#\\\/schema\\\/person\\\/185bd226f300ea376b71556a3861a2d2\"},\"headline\":\"The Right Format for Your Technical Documentation\",\"datePublished\":\"2015-03-03T20:30:11+00:00\",\"dateModified\":\"2019-02-18T20:42:54+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/\"},\"wordCount\":658,\"image\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2017\\\/04\\\/visuel_10-303x280.png\",\"articleSection\":[\"Technical communication strategy\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/\",\"url\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/\",\"name\":\"The Right Format for Your Technical Documentation - Lios\",\"isPartOf\":{\"@id\":\"http:\\\/\\\/www.lios.ca\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2017\\\/04\\\/visuel_10-303x280.png\",\"datePublished\":\"2015-03-03T20:30:11+00:00\",\"dateModified\":\"2019-02-18T20:42:54+00:00\",\"author\":{\"@id\":\"http:\\\/\\\/www.lios.ca\\\/#\\\/schema\\\/person\\\/185bd226f300ea376b71556a3861a2d2\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#primaryimage\",\"url\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2017\\\/04\\\/visuel_10-303x280.png\",\"contentUrl\":\"http:\\\/\\\/www.lios.ca\\\/wp-content\\\/uploads\\\/2017\\\/04\\\/visuel_10-303x280.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/blogue\\\/the-right-format-for-your-technical-documentation\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.lios.ca\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Right Format for Your Technical Documentation\"}]},{\"@type\":\"WebSite\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/#website\",\"url\":\"http:\\\/\\\/www.lios.ca\\\/\",\"name\":\"Lios\",\"description\":\"L&#039;information \u00e0 l&#039;oeuvre\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"http:\\\/\\\/www.lios.ca\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"http:\\\/\\\/www.lios.ca\\\/#\\\/schema\\\/person\\\/185bd226f300ea376b71556a3861a2d2\",\"name\":\"Pascal\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g\",\"caption\":\"Pascal\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"The Right Format for Your Technical Documentation - Lios","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/","og_locale":"en_US","og_type":"article","og_title":"The Right Format for Your Technical Documentation - Lios","og_description":"Are you thinking it\u2019s time to put your technical documentation into a new format? In this article, we\u2019ll go into the details of the formats most commonly used in technical documentation to help you choose the best one for your products and your clients. Paper Ah! Good ol\u2019 paper! Printed documents never go out of [&hellip;]","og_url":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/","og_site_name":"Lios","article_published_time":"2015-03-03T20:30:11+00:00","article_modified_time":"2019-02-18T20:42:54+00:00","og_image":[{"url":"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png","type":"","width":"","height":""}],"author":"Pascal","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Pascal","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#article","isPartOf":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/"},"author":{"name":"Pascal","@id":"http:\/\/www.lios.ca\/#\/schema\/person\/185bd226f300ea376b71556a3861a2d2"},"headline":"The Right Format for Your Technical Documentation","datePublished":"2015-03-03T20:30:11+00:00","dateModified":"2019-02-18T20:42:54+00:00","mainEntityOfPage":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/"},"wordCount":658,"image":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#primaryimage"},"thumbnailUrl":"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png","articleSection":["Technical communication strategy"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/","url":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/","name":"The Right Format for Your Technical Documentation - Lios","isPartOf":{"@id":"http:\/\/www.lios.ca\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#primaryimage"},"image":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#primaryimage"},"thumbnailUrl":"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png","datePublished":"2015-03-03T20:30:11+00:00","dateModified":"2019-02-18T20:42:54+00:00","author":{"@id":"http:\/\/www.lios.ca\/#\/schema\/person\/185bd226f300ea376b71556a3861a2d2"},"breadcrumb":{"@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#primaryimage","url":"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png","contentUrl":"http:\/\/www.lios.ca\/wp-content\/uploads\/2017\/04\/visuel_10-303x280.png"},{"@type":"BreadcrumbList","@id":"https:\/\/www.lios.ca\/en\/blogue\/the-right-format-for-your-technical-documentation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.lios.ca\/en\/"},{"@type":"ListItem","position":2,"name":"The Right Format for Your Technical Documentation"}]},{"@type":"WebSite","@id":"http:\/\/www.lios.ca\/#website","url":"http:\/\/www.lios.ca\/","name":"Lios","description":"L&#039;information \u00e0 l&#039;oeuvre","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"http:\/\/www.lios.ca\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"http:\/\/www.lios.ca\/#\/schema\/person\/185bd226f300ea376b71556a3861a2d2","name":"Pascal","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/0b61a5ec5d50484aabc9949da35a378871871e11bf276aa4d242d1d5c3ad948a?s=96&d=mm&r=g","caption":"Pascal"}}]}},"_links":{"self":[{"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/posts\/1290","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/comments?post=1290"}],"version-history":[{"count":6,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/posts\/1290\/revisions"}],"predecessor-version":[{"id":2273,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/posts\/1290\/revisions\/2273"}],"wp:attachment":[{"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/media?parent=1290"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/categories?post=1290"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.lios.ca\/en\/wp-json\/wp\/v2\/tags?post=1290"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}