{"id":11931,"date":"2018-04-06T08:08:02","date_gmt":"2018-04-06T12:08:02","guid":{"rendered":"http:\/\/www.analystik.ca\/blogue\/?p=11931"},"modified":"2019-04-18T15:29:56","modified_gmt":"2019-04-18T19:29:56","slug":"meilleures-pratiques-sauvegarde-documentation-projet-ti","status":"publish","type":"post","link":"https:\/\/analystik.ca\/blogue\/language\/fr\/meilleures-pratiques-sauvegarde-documentation-projet-ti\/","title":{"rendered":"Meilleures pratiques de sauvegarde de documentation d\u2019un projet TI"},"content":{"rendered":"<p>Il y a de bonnes et de meilleures pratiques de sauvegarde de documentation d\u2019un projet TI; en TI comme en toute chose.<\/p>\n<p>Dans les deux premiers billets de cette s\u00e9rie sur la documentation d\u2019un projet de d\u00e9veloppement TI, nous avons trait\u00e9 du \u00ab\u00a0quoi\u00a0\u00bb ou de ce qu\u2019il faut documenter et du \u00ab\u00a0comment\u00a0\u00bb ou, si vous pr\u00e9f\u00e9rez, du format que l\u2019on devrait utiliser.<\/p>\n<p>Dans ce billet, nous ne traiterons pas du \u00ab\u00a0pourquoi\u00a0\u00bb mais bien du \u00ab\u00a0o\u00f9\u00a0\u00bb sauvegarder la documentation d&rsquo;un Projet TI.<\/p>\n<p>Si vous pensez que ce billet sur la sauvegarde de documentation d&rsquo;un projet TI est le parent pauvre des deux pr\u00e9c\u00e9dents, d\u00e9trompez-vous.\u00a0 Trop souvent la documentation d&rsquo;un Projet TI n\u2019est pas consult\u00e9e parce qu\u2019elle n\u2019est pas facile d\u2019acc\u00e8s et, pour les m\u00eames raisons, la documentation n\u2019est souvent pas \u00e0 jour.<\/p>\n<p><!--more--><\/p>\n<p>Pour d\u00e9terminer le bon endroit o\u00f9 sauvegarder la documentation de votre Projet TI, il faut tenir compte de 3 facteurs\u00a0:<\/p>\n<ul>\n<li>Quelle est la documentation \u00e0 rendre accessible ?<\/li>\n<li>Qui sont les utilisateurs ou lecteurs ?<\/li>\n<li>Quelle est la fr\u00e9quence d\u2019utilisation (lecture et mise \u00e0 jour) ?<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>Les outils de sauvegarde de documentation de projet TI ne sont pas tous \u00e9gaux<\/h2>\n<p>&nbsp;<\/p>\n<p>Reprenons les documents mentionn\u00e9s dans les billets pr\u00e9c\u00e9dents\u00a0:<\/p>\n<ul>\n<li><strong>Les standards de conception et de r\u00e9alisation de l\u2019organisation<\/strong>: Pendant des ann\u00e9es, nous avons sauvegard\u00e9 ces documents, g\u00e9n\u00e9ralement sous format Word, dans notre biblioth\u00e8que d\u2019entreprise qui s\u2019appuyait sur SharePoint.\u00a0 Lors de la derni\u00e8re optimisation de nos m\u00e9thodes et processus, nous avons d\u00e9cid\u00e9 de rapprocher cette documentation des d\u00e9veloppeurs et nous l\u2019avons transf\u00e9r\u00e9 dans Visual Studio Team Services, dans un projet \u00ab\u00a0Documentation\u00a0\u00bb, pour en faciliter l\u2019accessibilit\u00e9.<\/li>\n<li>Quant aux <strong>comptes-rendus de r\u00e9union<\/strong>, nous les sauvegardons aussi dans Visual Studio Team Services mais cette fois-ci dans le projet lui-m\u00eame. De cette fa\u00e7on, ils sont disponibles \u00e0 l\u2019\u00e9quipe de d\u00e9veloppement et au client qui a aussi acc\u00e8s \u00e0 l\u2019outil.<\/li>\n<li>Les <strong>exigences d\u2019affaires et fonctionnelles<\/strong> qui sont sous le format Word pour permettre aux clients de facilement les \u00e9diter, sont eux aussi sauvegard\u00e9s dans le projet cr\u00e9\u00e9 dans Visual Studio Team Services.<\/li>\n<li>\u00c9videmment une des fonctionnalit\u00e9s de VSTS est de permettre aux gestionnaires de planifier. Cette <strong>planification<\/strong> se fait donc \u00e0 m\u00eame l\u2019outil.<\/li>\n<li>\u00c9videmment toute la <strong>documentation g\u00e9n\u00e9r\u00e9e par les d\u00e9veloppeurs<\/strong> eux-m\u00eames, que ce soit les notes dans le code, la documentation technique, les fichiers de design, tout est sauvegard\u00e9 \u00e0 m\u00eame l\u2019outil.<\/li>\n<li>Pour la <strong>documentation technique<\/strong>, une page du wiki est utilis\u00e9e pour l\u2019\u00e9diter.<\/li>\n<li>Finalement, pour faciliter l\u2019acc\u00e8s \u00e0 la documentation, dont celle qui est fr\u00e9quemment utilis\u00e9e, nous cr\u00e9ons pour chaque projet de d\u00e9veloppement un <strong>wiki de projet<\/strong> qui nous permet de filtrer la documentation \u00e0 exposer et de la rendre facilement disponible. On y retrouve\u00a0:\n<ul>\n<li>un sommaire des r\u00e9unions internes<\/li>\n<li>une page contenant les liens aux fichiers Word des r\u00e9unions externes<\/li>\n<li>un tableau des \u00ab\u00a0To-Do\u00a0\u00bb<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3><strong>Conclusion<\/strong><\/h3>\n<p>Il n\u2019y a pas si longtemps chez Analystik, nous retrouvions de la documentation sur notre serveur de fichiers, notre biblioth\u00e8que d\u2019entreprise, SharePoint et TFS (maintenant VSTS).<\/p>\n<p>Afin de mieux faire vivre notre documentation de projet de d\u00e9veloppement, nous l\u2019avons centralis\u00e9 dans une m\u00eame plateforme en distinguant ce qui est sp\u00e9cifique au projet et ce qui s\u2019adresse \u00e0 l\u2019organisation.\u00a0 De cette fa\u00e7on, tous les intervenants, autant internes qu\u2019externes, y ont facilement acc\u00e8s et le format utilis\u00e9 est g\u00e9n\u00e9ralement le meilleur pour chaque type d\u2019usagers.<\/p>\n<p>&nbsp;<\/p>\n<p>Bon projet de d\u00e9veloppement,<\/p>\n<p>&nbsp;<\/p>\n<p><strong>Denis Paul &amp; Michel<\/strong><\/p>\n<!-- AddThis Advanced Settings generic via filter on the_content --><!-- AddThis Share Buttons generic via filter on the_content -->","protected":false},"excerpt":{"rendered":"<p>Il y a de bonnes et de meilleures pratiques de sauvegarde de documentation d\u2019un projet TI; en TI comme en toute chose. Dans les deux premiers billets de cette s\u00e9rie sur la documentation d\u2019un projet de d\u00e9veloppement TI, nous avons trait\u00e9 du \u00ab\u00a0quoi\u00a0\u00bb ou de ce qu\u2019il faut documenter et du \u00ab\u00a0comment\u00a0\u00bb ou, si vous&#8230;  <a class=\"excerpt-read-more\" href=\"https:\/\/analystik.ca\/blogue\/language\/fr\/meilleures-pratiques-sauvegarde-documentation-projet-ti\/\" title=\"Read Meilleures pratiques de sauvegarde de documentation d\u2019un projet TI\">Read more &raquo;<\/a><!-- AddThis Advanced Settings generic via filter on wp_trim_excerpt --><!-- AddThis Share Buttons generic via filter on wp_trim_excerpt --><\/p>\n","protected":false},"author":3,"featured_media":11927,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"Meilleures pratiques de sauvegarde de documentation d\u2019un projet TI","_seopress_titles_desc":"Il y a de bonnes et de meilleures pratiques de sauvegarde de la documentation d\u2019un projet TI; comme en toute chose. Trop souvent la documentation d'un Projet TI n\u2019est pas consult\u00e9e parce qu\u2019elle n\u2019est pas facile d\u2019acc\u00e8s et, pour les m\u00eames raisons, la documentation n\u2019est souvent pas \u00e0 jour.","_seopress_robots_index":"","content-type":"","footnotes":""},"categories":[3565,3377],"tags":[4418,4416,4412,4414],"better_featured_image":{"id":11927,"alt_text":"","caption":"","description":"","media_type":"image","media_details":{"width":2880,"height":1800,"file":"2018\/04\/saved-3.jpg","sizes":{"thumbnail":{"file":"saved-3-63x63.jpg","width":63,"height":63,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-63x63.jpg"},"medium":{"file":"saved-3-300x188.jpg","width":300,"height":188,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-300x188.jpg"},"medium_large":{"file":"saved-3-768x480.jpg","width":768,"height":480,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-768x480.jpg"},"large":{"file":"saved-3-1024x640.jpg","width":1024,"height":640,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-1024x640.jpg"},"bones-thumb-2880":{"file":"saved-3-2880x1800.jpg","width":2880,"height":1800,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-2880x1800.jpg"},"bones-thumb-1920":{"file":"saved-3-1920x1271.jpg","width":1920,"height":1271,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-1920x1271.jpg"},"bones-thumb-1536":{"file":"saved-3-1536x1016.jpg","width":1536,"height":1016,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-1536x1016.jpg"},"bones-thumb-960":{"file":"saved-3-960x635.jpg","width":960,"height":635,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-960x635.jpg"},"bones-thumb-600":{"file":"saved-3-600x397.jpg","width":600,"height":397,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-600x397.jpg"},"bones-thumb-300":{"file":"saved-3-300x199.jpg","width":300,"height":199,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-300x199.jpg"},"post-thumbnail":{"file":"saved-3-125x125.jpg","width":125,"height":125,"mime-type":"image\/jpeg","source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3-125x125.jpg"}},"image_meta":{"aperture":"0","credit":"","camera":"","caption":"","created_timestamp":"0","copyright":"","focal_length":"0","iso":"0","shutter_speed":"0","title":"","orientation":"0","keywords":[]}},"post":null,"source_url":"https:\/\/analystik.ca\/blogue\/wp-content\/uploads\/2018\/04\/saved-3.jpg"},"_links":{"self":[{"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/posts\/11931"}],"collection":[{"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/comments?post=11931"}],"version-history":[{"count":3,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/posts\/11931\/revisions"}],"predecessor-version":[{"id":12021,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/posts\/11931\/revisions\/12021"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/media\/11927"}],"wp:attachment":[{"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/media?parent=11931"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/categories?post=11931"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/analystik.ca\/blogue\/wp-json\/wp\/v2\/tags?post=11931"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}