{"id":2777,"date":"2019-04-02T11:53:10","date_gmt":"2019-04-02T09:53:10","guid":{"rendered":"https:\/\/2019.paris.wordcamp.org\/?p=2777"},"modified":"2019-04-13T11:24:47","modified_gmt":"2019-04-13T09:24:47","slug":"atelier-8-la-documentation-de-wordpress","status":"publish","type":"post","link":"https:\/\/paris.wordcamp.org\/2019\/atelier-8-la-documentation-de-wordpress\/","title":{"rendered":"#Atelier 8 : la documentation de WordPress \ud83d\udcd3"},"content":{"rendered":"\n<p>Le mercredi 20 mars, un peu apr\u00e8s 18h30, notre avant derni\u00e8re s\u00e9ance de pr\u00e9paration \u00e0 la <a href=\"https:\/\/2019.paris.wordcamp.org\/contributor-day\/\">journ\u00e9e de contribution<\/a> du WordCamp (24 avril 2019) a r\u00e9uni quatre contributrices et quatre contributeurs au campus Parmentier de l&rsquo;Epitech de Paris. <a href=\"https:\/\/2019.paris.wordcamp.org\/les-equipes\/organisateur-rice-s\/#journee-de-contribution\">\u00c9ric<\/a> &amp; moi-m\u00eame \u00e9tions sur place pour animer la tabl\u00e9e et <a href=\"https:\/\/2019.paris.wordcamp.org\/les-equipes\/organisateur-rice-s\/#journee-de-contribution\">Jb<\/a> \u00e9tait exceptionnellement aux manettes du \u00ab&nbsp;<a href=\"#live-tweet\">live tweeting<\/a>&nbsp;\u00bb, notre experte <a href=\"https:\/\/2019.paris.wordcamp.org\/les-equipes\/organisateur-rice-s\/#communication\">Val\u00e9rie<\/a> n&rsquo;\u00e9tant pas disponible ce soir l\u00e0.<\/p>\n\n\n\n<!--more-->\n\n\n\n<h2 class=\"wp-block-heading\">Le compte-rendu \ud83d\udcc4<\/h2>\n\n\n\n<p>Le th\u00e8me qui nous r\u00e9unissait \u00e9tait la documentation du projet open source WordPress. Nous l&rsquo;avons abord\u00e9 en deux temps.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. Comment se documenter sur WordPress ?<\/h3>\n\n\n\n<p>Un tour de table au cours duquel nous avons partag\u00e9 nos sources de documentation montre un recours fr\u00e9quent aux moteurs de recherche, \u00e0 YouTube, au forum et au Slack de l\u2019association <a href=\"https:\/\/wpfr.net\/support\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\"WordPress Francophone (opens in a new tab)\">WordPress Francophone<\/a>. Le \u00ab\u00a0<a rel=\"noreferrer noopener\" aria-label=\"Codex (opens in a new tab)\" href=\"https:\/\/codex.wordpress.org\/fr:Accueil\" target=\"_blank\">Codex<\/a>\u00a0\u00bb de WordPress est \u00e9galement souvent cit\u00e9. Viennent ensuite les sites Internet (lorsqu&rsquo;ils existent) des th\u00e8mes ou extensions utilis\u00e9s. Et, notons le : <a href=\"https:\/\/2019.paris.wordcamp.org\/session\/devenir-un-developpeur-de-theme-en-2019\/\">Gr\u00e9goire Noyelle<\/a> a \u00e9galement \u00e9t\u00e9 mentionn\u00e9 \ud83d\udcaa.<\/p>\n\n\n\n<p>Nous avons vu qu&rsquo;il fallait \u00eatre prudent avec le Codex \u00e9tant donn\u00e9 que certaines informations n&rsquo;\u00e9taient plus d&rsquo;actualit\u00e9. Cela r\u00e9v\u00e8le notamment un des enjeux du processus de documentation d&rsquo;un projet open source : une n\u00e9cessit\u00e9 de mises \u00e0 jour fr\u00e9quentes et le plus proche du rythme des \u00e9volutions du code source du projet.<\/p>\n\n\n\n<p>Il existe 4 types de documentation pour WordPress :<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>le centre d&rsquo;aide \u00e0 l&rsquo;utilisation : \u00ab&nbsp;<a rel=\"noreferrer noopener\" aria-label=\"HelpHub (opens in a new tab)\" href=\"https:\/\/wordpress.org\/support\/\" target=\"_blank\">HelpHub<\/a>&nbsp;\u00bb,<\/li><li>les manuels de d\u00e9veloppement : \u00ab <a rel=\"noreferrer noopener\" aria-label=\"DevHub (opens in a new tab)\" href=\"https:\/\/developer.wordpress.org\/\" target=\"_blank\">DevHub<\/a> \u00bb,<\/li><li>la documentation <a href=\"https:\/\/developer.wordpress.org\/reference\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\"du (dans le) code (opens in a new tab)\">du (dans le) code<\/a>,<\/li><li>les manuels de contribution.<\/li><\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2. Contribuer \u00e0 la documentation de WordPress<\/h3>\n\n\n\n<p>La priorit\u00e9 de l&rsquo;\u00e9quipe de documentation de WordPress est d&rsquo;assurer la migration des contenus aujourd&rsquo;hui disponibles dans le Codex (bas\u00e9 sur le logiciel <a rel=\"noreferrer noopener\" aria-label=\"MediaWiki (opens in a new tab)\" href=\"https:\/\/www.mediawiki.org\/wiki\/MediaWiki\" target=\"_blank\">MediaWiki<\/a>) vers un nouveau centre d&rsquo;aide baptis\u00e9 \u00ab HelpHub \u00bb. Sa particularit\u00e9 est de se baser sur WordPress pour entretenir les contenus et ressources de documentation. Ce travail de migration n&rsquo;\u00e9tant pas automatis\u00e9, vous \u00eates les bienvenu\u00b7e\u00b7s pour apporter votre aide dans la r\u00e9alisation manuelle de cette tache.<\/p>\n\n\n\n<p>Vous pouvez \u00e9galement ou alternativement apporter votre pierre \u00e0 l&rsquo;\u00e9difice en contribuant \u00e0 rendre ce centre d&rsquo;aide disponible en fran\u00e7ais, puisqu&rsquo;une \u00e9quipe locale d\u00e9di\u00e9e a \u00e9t\u00e9 mise en place et que le Fran\u00e7ais, au m\u00eame titre que le Japonais, a \u00e9t\u00e9 choisi pour \u00eatre l&rsquo;un des deux pilotes du projet de localisation de cette documentation r\u00e9serv\u00e9e aux utilisateurs. Pour en savoir plus \u00e0 ce sujet, je vous invite \u00e0 prendre connaissance de cet article : <\/p>\n\n\n\n<figure class=\"wp-block-embed-wordpress aligncenter wp-block-embed is-type-wp-embed is-provider-translate-wordpress\"><div class=\"wp-block-embed__wrapper\">\nhttps:\/\/make.wordpress.org\/polyglots\/2019\/02\/25\/helphub-localisation-plan\/\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Rediffusion de l\u2019atelier<\/h2>\n\n\n\n<p>Comme tous les ateliers pr\u00e9c\u00e9dents, nous avons diffus\u00e9 en direct nos \u00e9changes ce qui a permis \u00e0 neuf autres contributeur\u00b7rice\u00b7s d&rsquo;en profiter \u00e0 distance. Si vous souhaitez les (re)voir, voici ci-apr\u00e8s la vid\u00e9o que nous avons enregistr\u00e9e.<\/p>\n\n\n\n<figure class=\"wp-block-embed-youtube alignwide wp-block-embed is-type-video is-provider-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<span class=\"embed-youtube\" style=\"text-align:center; display: block;\"><iframe loading=\"lazy\" class=\"youtube-player\" width=\"640\" height=\"360\" src=\"https:\/\/www.youtube.com\/embed\/QJCw8Hp96dc?version=3&#038;rel=1&#038;showsearch=0&#038;showinfo=1&#038;iv_load_policy=1&#038;fs=1&#038;hl=fr-FR&#038;autohide=2&#038;wmode=transparent\" allowfullscreen=\"true\" style=\"border:0;\" sandbox=\"allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox\"><\/iframe><\/span>\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Ma pr\u00e9sentation<\/h2>\n\n\n\n<figure class=\"wp-block-image alignwide\"><a href=\"https:\/\/slides.com\/imath\/deck-2\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"640\" src=\"https:\/\/2019.paris.wordcamp.org\/files\/2019\/03\/atelier-8-slides-cover-1024x640.jpg\" alt=\"Lien vers la pr\u00e9sentation du 8e atelier de pr\u00e9paration \u00e0 la journ\u00e9e de contribution\" class=\"wp-image-2782\" srcset=\"https:\/\/paris.wordcamp.org\/2019\/files\/2019\/03\/atelier-8-slides-cover.jpg 1024w, https:\/\/paris.wordcamp.org\/2019\/files\/2019\/03\/atelier-8-slides-cover-300x188.jpg 300w, https:\/\/paris.wordcamp.org\/2019\/files\/2019\/03\/atelier-8-slides-cover-768x480.jpg 768w, https:\/\/paris.wordcamp.org\/2019\/files\/2019\/03\/atelier-8-slides-cover-480x300.jpg 480w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Soyez pr\u00e9sent\u00b7e au <del>prochain<\/del> dernier atelier de pr\u00e9paration !<\/h2>\n\n\n\n<p>Pour l&rsquo;ultime \u00e9pisode de notre s\u00e9rie d&rsquo;ateliers, nous vous proposerons de travailler ensemble sur l&rsquo;accessibilit\u00e9 des th\u00e8mes WordPress. Il se d\u00e9roulera le 11 avril prochain chez Firefox France \u00e0 l&rsquo;heure habituelle 18h30. Pour vous inscrire, il vous suffit de vous rendre sur cette page du groupe meetup parisien.<\/p>\n\n\n\n<figure class=\"wp-block-embed-meetup-com alignwide wp-block-embed is-type-rich is-provider-meetup\"><div class=\"wp-block-embed__wrapper\">\nhttps:\/\/www.meetup.com\/wordpress-ile-de-france\/events\/260243081\/\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"live-tweet\">Les moments forts de nos \u00e9changes.<\/h2>\n\n\n\n<figure class=\"wp-block-embed-twitter aligncenter wp-block-embed is-type-rich is-provider-twitter\"><div class=\"wp-block-embed__wrapper\">\n<a class=\"twitter-moment\" data-width=\"640\" data-dnt=\"true\" href=\"https:\/\/twitter.com\/i\/moments\/1108602641700016129?ref_src=twsrc%5Etfw\">Contributor Day Atelier #8<\/a><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script>\n<\/div><\/figure>\n\n\n\n<p class=\"has-small-font-size\"><em>Cr\u00e9dits image \u00e0 la une : \u00c9ric Martin<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Le mercredi 20 mars, un peu apr\u00e8s 18h30, notre avant derni\u00e8re s\u00e9ance de pr\u00e9paration \u00e0 la journ\u00e9e de contribution du WordCamp (24 avril 2019) a r\u00e9uni quatre contributrices et quatre contributeurs au campus Parmentier de l&rsquo;Epitech de Paris. \u00c9ric &amp; moi-m\u00eame \u00e9tions sur place pour animer la tabl\u00e9e et Jb \u00e9tait exceptionnellement aux manettes du &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/paris.wordcamp.org\/2019\/atelier-8-la-documentation-de-wordpress\/\" class=\"more-link\">Continuer la lecture <span class=\"screen-reader-text\"> \u00ab\u00a0#Atelier 8 : la documentation de WordPress \ud83d\udcd3\u00a0\u00bb<\/span><\/a><\/p>\n","protected":false},"author":6594935,"featured_media":2800,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[1268829,1265960],"tags":[1265961],"class_list":["post-2777","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-atelier-de-contribution","category-journee-de-contribution","tag-atelier","entry"],"jetpack_featured_media_url":"https:\/\/paris.wordcamp.org\/2019\/files\/2019\/03\/wcparis2019-atelier8.jpg","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pa49y4-IN","jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/posts\/2777","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/users\/6594935"}],"replies":[{"embeddable":true,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/comments?post=2777"}],"version-history":[{"count":18,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/posts\/2777\/revisions"}],"predecessor-version":[{"id":3146,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/posts\/2777\/revisions\/3146"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/media\/2800"}],"wp:attachment":[{"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/media?parent=2777"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/categories?post=2777"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/paris.wordcamp.org\/2019\/wp-json\/wp\/v2\/tags?post=2777"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}