<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Adrien Guéret on Medium]]></title>
        <description><![CDATA[Stories by Adrien Guéret on Medium]]></description>
        <link>https://medium.com/@adriengueret?source=rss-6ecebb1962ab------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*dC3vcp_RO1iiUmqk19O3-Q.jpeg</url>
            <title>Stories by Adrien Guéret on Medium</title>
            <link>https://medium.com/@adriengueret?source=rss-6ecebb1962ab------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 23:03:10 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@adriengueret/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Writing an Article in the Age of AI — Part 2]]></title>
            <link>https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-2-e8eacfdb8d0f?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/e8eacfdb8d0f</guid>
            <category><![CDATA[education]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <category><![CDATA[article-writing]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Wed, 25 Feb 2026 11:42:45 GMT</pubDate>
            <atom:updated>2026-02-25T11:46:37.243Z</atom:updated>
            <content:encoded><![CDATA[<h4>How to Go About It?</h4><p><em>This article is the direct continuation of </em><a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-1-61916a3cd90e"><strong><em>Writing an Article in the Age of AI — Part 1: Is It Really Useful?</em></strong></a><strong><em><br></em></strong><em>It is </em><strong><em>not</em></strong><em> necessary to have read the first part to read this article, but the reflection discussed there might interest you!</em></p><p>Congratulations! You’ve realized that you have experiences to share and you’ve motivated yourself to write an article. So you launch your favorite text editor and… panic sets in. The blank page. Your fingers refuse to move across the keyboard.</p><p>Wanting to write is the easy part! The hardest thing is to actually get started and begin writing.</p><p>If, as I often hear, you tell yourself “I don’t know how to write,” know that you’re far from alone. It’s not inevitable!</p><p>As we saw in <a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-1-61916a3cd90e">the previous article</a>, more than half of the content on the Internet today is <strong>not</strong> generated by humans. You might be thinking that you too could take advantage of new technologies, and in particular these two words: <strong>artificial intelligence</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*SCNZqfWKRqUsEophZZkoZg.png" /><figcaption>“You know, kid, these two words will solve all your problems.” (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>It’s <strong>not necessarily</strong> a good idea.<br>Well… It depends on your approach. Let me explain.</p><h3>The Mistake to Avoid: Making AI Your Author Who You Commission an Article From</h3><p>The easiest thing would be to write a prompt to get your article in less time than it takes to say it. For example:</p><blockquote>Write an article, ready for publication, about the importance of writing our own articles in the age of artificial intelligence.</blockquote><p>As an anecdote, I used this prompt with Gemini and it generated t<a href="https://medium.com/@adriengueret/the-soul-in-the-machine-cc9fa9f926dd">his article</a>. Only read it if you’re curious about the result (it only takes two minutes), but know that I didn’t edit anything at all: it was written 100% by AI.<br>I don’t deny it has qualities: it gets straight to the point, reads quickly, and explains concepts well. But its style is very standardized, sometimes even a bit clunky.</p><p>In terms of content, it barely scratches the surface of the subject.<br>In terms of form, it’s as if you’ve already read it.<br>It has no personality. Nothing truly original. Nothing creative.</p><p>In short: <strong>an article written entirely by AI has no soul.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*0dsHAPdOqJxfLUvrCgHRCw.png" /><figcaption>It’s all well and good to use new technologies, but sometimes something’s missing… right? (<strong><em>The Lion King</em></strong>, 2019)</figcaption></figure><p>Some will say that it’s enough to ask the AI to apply a particular tone, or even to copy the style of another author for the less scrupulous… The results might be a bit better, but the tone will remain generally very “mechanical.”</p><p>My way of treating the subject “<strong>Writing an Article in the Age of AI</strong>” is much more “human” in its form: I try to capture your attention, I adopt a generally light tone to make your reading flow, I address <strong>you</strong> directly as an individual reader.<br>I placed images from <strong>The Lion King</strong> to illustrate my points because I wanted to touch your nostalgic chord. Even if we don’t know each other, I know that we have in common this popular culture that speaks to us, humans.</p><p>Yes, the risk is that it won’t please everyone. At this stage of the article, if you’re still reading, it’s because you like my tone, and that’s great! But it’s indeed possible that I’ve lost quite a few readers who found my style a bit heavy-handed… And that’s too bad! <em>(they’re missing out on a great article, so they’re the ones to feel sorry for, right?)</em></p><p>The advantage of AI’s sanitized tone is that it’s standardized to avoid raising eyebrows. It’s banal, but it’s neutral.<br>I deliberately chose an opposite tone to write this series of two articles.</p><p>For your own articles, there’s probably a happy medium to find.<br>And to do that, we’re going to use <strong>artificial intelligence</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*Bs3lmsvGUovHTiDk_fRySA.png" /><figcaption>“Hey, you said uh…” (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><h3>The Right Approach: Making AI Your Advisor to Improve Your Article.</h3><p>Whatever the field, <strong>asking AI to do all the work for you is generally a bad idea</strong>.<br>On the other hand, using AI to improve your own work — now that becomes interesting!</p><p>Start by structuring your ideas. <strong>If you’re not comfortable with writing, there’s no need to write prose</strong>: even simple bullet points are enough! You’ll ask an AI to format all that.<br>Start a conversation with your favorite artificial intelligence and give it the context of your project. For example:</p><blockquote>I’m writing an article about {YOUR TOPIC}. Here are my ideas for the introduction: {YOUR IDEAS}.<br>Help me shape them into a smooth, reader-friendly introduction.</blockquote><p>It’s a somewhat basic prompt, which you can refine according to your preferences, but it already gives good results!<br><strong>That said, avoid simply copying and pasting the AI’s response.</strong> Rework it and constantly ask yourself the question: “Would I have said it like that?” Don’t hesitate to infuse your own tone and give personality (<strong>your</strong> personality!) to <strong>your</strong> article.<br>Never forget that: it’s <strong>your</strong> article. It should feel like it’s <strong>you</strong> talking to us, not a machine!</p><p>The best approach is to write as much as you can yourself and then ask the AI to improve what you’ve written. The most obvious is to detect mistakes: spelling or grammar errors are in trouble!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bUUTC4jSLufPU9s70H23Eg.png" /><figcaption>Your future teamwork with AI, an allegory. (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>To go further, you can ask the AI to review the structure of a sentence to make the reading more natural.<br>Actually, that’s exactly what I just did for that last sentence!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/988/1*K60S2858iYuROVKAY293pQ.jpeg" /></figure><p>Moreover, I <strong>didn’t</strong> take one of these suggestions as is: I rather made a mix between my original sentence and the different proposals. Don’t forget the essential: <strong>always make the AI’s response your own!</strong></p><p>Artificial intelligences are also pretty good at translating text. If you want to extend the reach of your article, making a version in another language can greatly help!<br>The article you’re currently reading is actually an AI translation of <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-2-bc14e0b193ee">this original french article</a>. Pretty good, right?</p><h3>So… What Are You Waiting For?</h3><p>Whether it’s a child learning from their parents, a student guided by a teacher, or an apprentice trained by their peers, education is an integral part of our evolution. Human beings have always grown by sharing <strong>their</strong> knowledge and <strong>their</strong> experiences.</p><p>But — I’m repeating myself a bit but it’s important to remember — more than half of the content on the Internet today is generated by machines…</p><p>Isn’t that a bit worrying?<br>Are we ready to entrust new technologies with the generation of our knowledge?</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*QBgVDi-1E_ar3ULDdZIwtw.png" /><figcaption>What legacy will we leave to future generations? (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>It might be smarter to use these technologies to share even more. <a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-1-61916a3cd90e">You have plenty of things to tell</a>, and you now have the best tools to help you do it… so go ahead!</p><p>You just need to use artificial intelligence… <strong>intelligently</strong>.</p><p>And you’re capable of that, aren’t you?</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e8eacfdb8d0f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-2-e8eacfdb8d0f">Writing an Article in the Age of AI — Part 2</a> was originally published in <a href="https://medium.com/openclassrooms-product-design-and-engineering">Product, Experience &amp; Technology @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Writing an Article in the Age of AI — Part 1]]></title>
            <link>https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-1-61916a3cd90e?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/61916a3cd90e</guid>
            <category><![CDATA[motivation]]></category>
            <category><![CDATA[article-writing]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Wed, 25 Feb 2026 11:42:16 GMT</pubDate>
            <atom:updated>2026-02-25T11:44:57.000Z</atom:updated>
            <content:encoded><![CDATA[<h3>Writing an Article in the Age of AI — Part 1</h3><h4>Is It Really Worth It?</h4><p>Of course! Here’s a structured, impactful article proposal, optimized for smooth reading. It adopts an analytical yet engaging tone, ideal for a professional blog, LinkedIn, or a specialized newsletter.</p><p>If you’re a human like me, congratulations: according to a 2025 study, you’re part of <a href="https://cyberpress.org/ai-driven-bad-bots-now-make-up/">less than half of Internet traffic</a>.</p><p>But more importantly, I imagine you’re rolling your eyes thinking something along the lines of:</p><blockquote>What an idiot this author is, he just copy-pasted ChatGPT’s answer without even reading it.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*QYmYwLLmqS3svAL-w_HqcQ.png" /><figcaption>“I’m surrounded by idiots.” (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>Well, first of all, know that it’s not very nice to call me an idiot, but more importantly, you’re wrong! This article is indeed written by hand, by a real human, with flaws and a personal writing style. The opening line was just a joke — I’ll leave you to judge its effectiveness.<br><em>(To be 100% transparent: this article was originally written by hand in french, </em><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4"><em>you can find it here</em></a><em>, but has been translated in english with artificial intelligence.)</em></p><p>Let’s come back to that stat from earlier: <strong>more than half of Internet traffic is now caused by bots</strong>: AIs, automated scripts… in short, by <em>things</em> that aren’t really human.</p><p>This figure also applies to AI-generated content: <strong>our machines now create more content than we do</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*JL494tYlSySZDNAL2cuXQQ.png" /><figcaption>AI-generated content has now surpassed that created by humans (<a href="https://graphite.io/five-percent/more-articles-are-now-created-by-ai-than-humans">Graphie.io</a>)</figcaption></figure><p>So the question we need to ask ourselves today: what’s in it for me, as a human, to write an article?</p><h3>What’s the Point of Writing an Article?</h3><p>It’s very common to believe that writing an article is just about <strong>transmitting knowledge</strong>. While that is indeed one of the goals, fortunately it’s not the only one!</p><p><strong>Writing an article is above all about organizing your own knowledge.</strong></p><blockquote>What is clearly conceived is clearly stated, and the words to say it flow with ease.<br>_ Nicolas Boileau</blockquote><p>If you decide to write an article on a technical subject (for example, <a href="https://medium.com/openclassrooms-product-design-and-engineering/leveraging-openapi-part-1-creating-and-maintaining-your-api-documentation-3f4b4535634a">maintaining an API via OpenAPI)</a>, you’ll need to do a quick introspection of your own knowledge to make sure you don’t talk nonsense.</p><p>You’ll analyze what you know, you’ll research your topic, you’ll try to simplify your knowledge to explain it and write it down in black and white (or white on black if you prefer <em>dark mode</em>).</p><p><strong>In short, not only will you transmit your knowledge, but you’ll also consolidate it.</strong></p><p>If you ask an AI to write everything for you, this step will be completely lost, drastically reducing the value of the article for you.</p><p>Of course, don’t put words in my mouth: <strong>an article must also be valuable to the reader</strong>, it doesn’t all revolve exclusively around you!</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*qa1Dw9m9fLW1mwVlmMZaiA.png" /><figcaption>Unfortunately, you’re not (yet) the king. (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>If your goal is to be read, you’ll need to find a topic that can interest readers (and by “readers,” I mean “humans,” which seems important to specify nowadays…).</p><h3>But I Have Nothing to Say! All Topics Have Already Been Covered!</h3><p>You’re both right and wrong!</p><p>You’re right, because indeed all topics have been covered. Especially with AIs generating hundreds of articles per minute that all look the same.</p><p>And you’re wrong, because you do have things to say! Lots of them! And there is at least one topic an AI can never take from you: <strong>your experience</strong>.</p><p>If today <strong>explaining how to do something specific</strong> is no longer really useful, <strong>sharing your experience</strong> <strong>on various subjects has much more value</strong>.</p><p>AIs can write articles explaining complex concepts on the fly, sure, but <strong>they can never share their own feelings as well as we can.</strong> What’s more human than expressing your feelings about a lived experience?</p><p>This is what will set your articles apart from all those generated by AI. <strong>Your authenticity is now your added value</strong>.</p><p>And the best part: since it’s <strong>your</strong> experience, it will necessarily be <strong>unique</strong>. No one else could have written an article on this subject!</p><p>Have you implemented <em>Clean Architecture</em> in your company? Have you migrated a 15-year-old project to <em>Next.js</em>? Have you trained for a marathon even though you’re not an athlete? Have you taken on the challenge of giving up meat entirely?</p><p>No matter the subject: you’re probably not the only one in the world to have done it, but <strong>your experience, the challenges you encountered, and the lessons you learned from it are unique</strong>. And that might interest other people!</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*QT10OTkIRXEizo3HdUWhIg.png" /><figcaption>“The past can hurt, but the way I see it, you can either run from it or learn from it.” (<strong><em>The Lion King</em></strong>, 1994)</figcaption></figure><p>In short: <strong>you have things to say.</strong> So don’t hesitate, and do it!</p><h3>OK fine, but I don’t like writing. I don’t have a “style,” I don’t know how to write an article properly.</h3><p>Sometimes due to lack of time, often due to undervaluing their own writing skills, people who have experiences to share are very often those who don’t take the time to write them down.</p><p>If you’re in this situation and this article has motivated you despite everything to write your own, I invite you to check out its sequel: <a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-2-e8eacfdb8d0f"><strong>Writing an Article in the Age of AI — Part 2: How to Go About It?</strong></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=61916a3cd90e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-1-61916a3cd90e">Writing an Article in the Age of AI — Part 1</a> was originally published in <a href="https://medium.com/openclassrooms-product-design-and-engineering">Product, Experience &amp; Technology @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Écrire un article à l’ère de l’IA — Partie 2]]></title>
            <link>https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-2-bc14e0b193ee?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/bc14e0b193ee</guid>
            <category><![CDATA[education]]></category>
            <category><![CDATA[article-writing]]></category>
            <category><![CDATA[artificial-intelligence]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 23 Feb 2026 11:00:55 GMT</pubDate>
            <atom:updated>2026-02-25T11:47:22.687Z</atom:updated>
            <content:encoded><![CDATA[<h4>Comment s’y prendre ?</h4><p><em>Cet article est la suite directe de </em><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4"><strong><em>Écrire un article à l’ère de l’IA — Partie 1 : est-ce vraiment utile ?</em></strong></a><strong><em><br></em></strong><em>Il n’est </em><strong><em>pas</em></strong><em> nécessaire d’avoir lu la première partie pour lire cet article, mais la réflexion qui y est évoquée peut vous intéresser !</em></p><p>Félicitations ! Vous avez réalisé que vous avez des expériences à partager et vous vous êtes motivé à écrire un article. Vous lancez donc votre éditeur de texte préféré et… c’est l’angoisse. La page blanche. Vos doigts refusent de parcourir le clavier.</p><p>Avoir envie d’écrire, c’est la partie la plus simple ! Le plus difficile, c’est de s’y mettre pour de vrai et de commencer la rédaction.<br>Si, comme je l’entends souvent, vous vous dites “je ne sais pas écrire”, sachez que vous êtes loin d’être seul. Ce n’est pas une fatalité !</p><p>Comme on l’a vu dans <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4">l’article précédent</a>, plus de la moitié du contenu sur Internet n’est aujourd’hui <strong>pas</strong> généré par des humains. Vous vous dites peut-être que vous aussi vous pourriez profiter des nouvelles technologies, et en particulier de ces deux mots : l’<strong>intelligence artificielle</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*SCNZqfWKRqUsEophZZkoZg.png" /><figcaption>“C’est fastoche : ces deux mots régleront tous tes problèmes !” (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>Ce n’est <strong>pas</strong> <strong>forcément</strong> une bonne idée.<br>Enfin… Tout dépend de votre approche. Je vous explique.</p><h3>L’erreur à éviter : faire de l’IA votre auteur à qui vous commandez un article</h3><p>Le plus simple serait d’écrire un prompt pour avoir votre article en moins de temps qu’il ne faut pour le dire. Par exemple :</p><blockquote>Rédige moi un article, prêt à être publié, qui parle de la pertinence d’écrire soi-même des articles à l’ère de l’intelligence artificielle.</blockquote><p>Pour l’anecdote, j’ai utilisé ce prompt avec Gemini et ça m’a généré <a href="https://medium.com/@adriengueret/l%C3%A2me-dans-la-machine-31d9bcf37493">cet article</a>. Lisez-le que si vous êtes curieux du résultat (ça ne prend que deux minutes), mais sachez que je n’y ai absolument rien retouché : il a été rédigé par une IA à 100%.<br>Je ne nie pas qu’il a des qualités : il va droit au but, se lit rapidement et explique bien les concepts. Mais son style est très standardisé, parfois même un peu bancal.</p><p>Sur le fond, il effleure juste la surface du sujet.<br>Sur la forme, c’est comme si vous l’aviez déjà lu.<br>Il n’a pas de personnalité. Rien de vraiment original. Rien de créatif.</p><p>En bref : <strong>un article rédigé entièrement par IA n’a pas d’âme.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*0dsHAPdOqJxfLUvrCgHRCw.png" /><figcaption>C’est bien beau d’utiliser les nouvelles technologies, mais il manque parfois un petit quelque chose… non ? (<strong><em>Le Roi Lion</em></strong>, 2019)</figcaption></figure><p>Certains diront qu’il suffit de demander à l’IA d’appliquer un ton particulier, voire de copier le style d’un autre auteur pour les moins scrupuleux… Les résultats seraient peut-être un peu meilleurs, mais le ton restera globalement très “mécanique”.</p><p>Ma façon de traiter le sujet “<strong>Écrire un article à l’ère de l’IA</strong>” est bien plus “humaine” sur sa forme : j’essaye de capter votre intention, je mets un ton globalement léger pour fluidifier votre lecture, je m’adresse directement à <strong>vous</strong> en tant que lecteur individuel.<br>J’ai placé des images du<strong> Roi Lion</strong> pour illustrer mes propos non pas par hasard mais pour toucher votre corde nostalgique car, même si on ne se connait pas, je sais qu’on a en commun cette culture populaire qui nous parle à nous, les humains.</p><p>Alors oui, le risque est que ça ne plaise pas à tout le monde. À ce stade de l’article, si vous lisez encore c’est que mon ton vous plait, et c’est tant mieux ! Mais il est effectivement possible que j’ai perdu pas mal de lecteurs qui ont trouvé mon style un peu lourdingue… Et c’est tant pis ! <em>(ils ratent un super article, donc ce sont les plus à plaindre, pas vrai ?)</em></p><p>L’avantage du ton aseptisé de l’IA est qu’il est standardisé pour ne pas faire sourciller les gens. C’est banal, mais c’est neutre.<br>J’ai volontairement choisi un ton opposé pour rédiger cette série de deux articles.</p><p>Pour vos propres articles, il y a sans doute un juste milieu à trouver.<br>Et pour se faire, on va se servir de l’<strong>intelligence artificielle</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*Bs3lmsvGUovHTiDk_fRySA.png" /><figcaption>“Hé, mais t’avais dit que…” (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><h3>La bonne démarche : faire de l’IA votre conseiller pour améliorer votre article.</h3><p>Quel que soit le domaine, <strong>demander à l’IA de faire tout le travail pour vous est généralement une mauvaise idée</strong>.<br>Par contre, s’aider de l’IA pour améliorer votre propre travail, là, ça devient intéressant !</p><p>Commencez par structurer vos idées. <strong>Si vous n’êtes pas à l’aise en écriture, inutile d’écrire des proses </strong>: même de simples listes à puce suffisent ! Vous demanderez à une IA de mettre en forme tout ça.<br>Lancez une conversation avec votre intelligence artificielle préférée et donnez-lui le contexte de votre projet. Par exemple :</p><blockquote>Je veux écrire un article sur {VOTRE SUJET}. Voici mes idées pour l’introduction : {VOS IDÉES}.<br>Aide-moi à les mettre en forme pour que ça soit agréable à lire pour les lecteurs.</blockquote><p>C’est un prompt un peu basique, que vous pouvez affiner selon vos envies, mais il donne déjà de bons résultats !<br><strong>Évitez cela dit de simplement copier/coller la réponse de l’IA. </strong>Retravaillez-la et posez-vous sans cesse la question : “Est-ce que j’aurais dit ça comme ça ?”. N’hésitez pas à insuffler votre propre ton et à donner de la personnalité (<strong>votre </strong>personnalité !) à <strong>votre </strong>article.<br>Car oui, c’est <strong>votre</strong> article. On doit avoir l’impression que c’est <strong>vous</strong> qui nous parlez, et non une machine !</p><p>Le mieux reste d’écrire vous-même un maximum de choses puis de demander à l’IA d’améliorer ce que vous avez écrit. Le plus évident est de détecter les fautes : les erreurs d’orthographe ou de grammaire ont du souci à se faire !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*23E4U1q7BaeCSID3McIjzw.png" /><figcaption>Votre futur travail d’équipe avec l’IA, allégorie. (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>Pour aller plus loin, vous pouvez demander à l’IA de revoir la structure d’une phrase spécifique afin de rendre la lecture plus naturelle.<br>Tiens d’ailleurs, c’est exactement ce que je viens de faire pour cette dernière phrase !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/988/1*dACSRcz9resJ80uD1itYWw.png" /></figure><p>Je n’ai d’ailleurs <strong>pas</strong> pris une de ces suggestions telle qu’elle : j’ai plutôt fait un mix entre ma phrase d’origine et les différentes propositions. N’oubliez pas l’essentiel : <strong>toujours se réapproprier la réponse de l’IA !</strong></p><p>Les intelligences artificielles sont également plutôt douées pour traduire du texte. Si vous souhaitez étendre la portée de votre article, en faire une version dans une autre langue peut grandement aider ! <br>L’article que vous êtes en train de lire a d’ailleurs été traduit en anglais avec une IA, vous pouvez voir <a href="https://medium.com/openclassrooms-product-design-and-engineering/writing-an-article-in-the-age-of-ai-part-2-e8eacfdb8d0f">le résultat ici</a>. Plutôt pas mal, non ?</p><h3>Alors… Qu’attendez-vous ?</h3><p>Qu’il s’agisse d’un enfant qui apprend de ses parents, d’un étudiant guidé par un professeur ou d’un apprenti formé par ses pairs, l’éducation fait partie intégrante de notre évolution. L’être humain a toujours grandi en partageant <strong>ses </strong>connaissances et <strong>ses </strong>retours d’expériences.</p><p>Or - je radote un peu mais c’est important de le rappeler - plus de la moitié du contenu sur Internet est aujourd’hui généré par des machines…</p><p>N’est-ce pas un peu inquiétant ?<br>Sommes-nous prêts à confier aux nouvelles technologies la génération de nos connaissances ?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*QBgVDi-1E_ar3ULDdZIwtw.png" /><figcaption>Quel héritage allons-nous laisser aux prochaines générations ? (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>Il serait peut-être plus malin d’utiliser ces technologies pour partager encore davantage. <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4">Vous avez des tas de choses à raconter</a>, et vous avez désormais les meilleurs outils pour vous aider à le faire… alors allez-y !</p><p>Il suffit simplement d’utiliser l’intelligence artificielle… <strong>intelligemment</strong>.</p><p>Et vous en êtes capable, pas vrai ?</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bc14e0b193ee" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-2-bc14e0b193ee">Écrire un article à l’ère de l’IA — Partie 2</a> was originally published in <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie">Technologie @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Écrire un article à l’ère de l’IA — Partie 1]]></title>
            <link>https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/ca87ef668ef4</guid>
            <category><![CDATA[artificial-intelligence]]></category>
            <category><![CDATA[article-writing]]></category>
            <category><![CDATA[motivation]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 23 Feb 2026 11:00:31 GMT</pubDate>
            <atom:updated>2026-02-23T11:01:55.496Z</atom:updated>
            <content:encoded><![CDATA[<h3>Écrire un article à l’ère de l’IA — Partie 1</h3><h4>Est-ce vraiment utile ?</h4><p>Bien sûr ! Voici une proposition d’article structuré, percutant et optimisé pour une lecture fluide. Il adopte un ton analytique mais engagé, idéal pour un blog professionnel, LinkedIn ou une newsletter spécialisée.</p><p>Si vous êtes un humain comme moi, déjà félicitations à vous : selon une étude en 2025 vous faites partie de <a href="https://cyberpress.org/ai-driven-bad-bots-now-make-up/">moins de la moitié du traffic sur Internet</a>.<br>Mais surtout, j’imagine que vous levez les yeux au ciel en pensant quelque chose qui ressemble à peu près à ça :</p><blockquote>Quel idiot cet auteur, il a copié/collé la réponse de ChatGPT sans même la lire.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*QYmYwLLmqS3svAL-w_HqcQ.png" /><figcaption>“Je patauge dans l’imbécilité.” (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>Hé bien sachez tout d’abord que ce n’est pas très gentil de me traiter d’idiot, mais en plus vous avez tort ! Cet article est bel et bien écrit à la main, par un vrai humain, avec ses failles et son propre style d’écriture. La phrase d’introduction n’était qu’une boutade, je vous laisse seul juge de son efficacité.</p><p>Revenons sur la stat de tout à l’heure : <strong>plus de la moitié du traffic Internet est désormais causée par des bots</strong> : des IA, des scripts automatiques… bref, par des <em>trucs</em> pas vraiment humains. <br>Ce chiffre est également valable pour le contenu généré par intelligence artificielle : <strong>nos machines créent aujourd’hui plus de contenu que nous</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JL494tYlSySZDNAL2cuXQQ.png" /><figcaption>Le contenu généré par intelligence artificielle a désormais dépassé celui créé par des humains (<a href="https://graphite.io/five-percent/more-articles-are-now-created-by-ai-than-humans">Graphie.io</a>)</figcaption></figure><p>La question qu’on doit donc se poser aujourd’hui : quel est mon intérêt, en tant qu’humain, pour rédiger un article ?</p><h3>À quoi ça sert d’écrire un article ?</h3><p>Il est très commun de croire qu’écrire un article sert juste à <strong>transmettre un savoir</strong>. S’il s’agit effectivement d’un des objectifs, ce n’est heureusement pas le seul ! <br><strong>Écrire un article, c’est avant tout mettre à plat ses propres connaissances.</strong></p><blockquote>Ce que l’on conçoit bien s’énonce clairement, et les mots pour le dire arrivent aisément.<br>_ Nicolas Boileau-Despréaux</blockquote><p>Si vous décidez d’écrire un article sur un sujet technique (par exemple <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/exploiter-openapi-1%C3%A8re-partie-cr%C3%A9er-et-maintenir-une-documentation-api-396295f2dade">la maintenance d’une API via OpenAPI</a>), vous allez devoir faire une rapide introspection de vos propres connaissances pour être sûr de ne pas raconter de bêtises.<br>Vous analyserez ce que vous savez, vous vous documenterez sur votre sujet, vous essayerez de vulgariser votre savoir pour pouvoir l’expliquer et l’écrire noir sur blanc (ou banc sur noir si vous préférez le <em>dark mode</em>).</p><p><strong>En bref, non seulement vous allez transmettre vos connaissances, mais en plus vous allez les consolider.</strong></p><p>Si vous demandez à une IA de tout écrire pour vous, cette étape sera complètement perdue, diminuant drastiquement l’intérêt de l’article pour vous.</p><p>Alors bien sûr, ne me faites pas dire ce que je n’ai pas dit : <strong>l’intérêt d’un article doit aussi exister pour le lecteur</strong>, tout ne tourne pas exclusivement autour de vous !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*qa1Dw9m9fLW1mwVlmMZaiA.png" /><figcaption>Vous n’êtes malheureusement pas (encore) le roi. (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>Si votre but est d’être lu, il va falloir trouver un sujet qui peut intéresser les lecteurs (et par “les lecteurs”, il faut comprendre “les humains” hein, ça semble important de le préciser à notre époque…).</p><h3>Mais je n’ai rien à raconter ! Tous les sujets ont déjà été évoqués !</h3><p>Vous avez à la fois raison et tort !<br>Vous avez raison, car effectivement tous les sujets ont été évoqués. D’autant plus avec les IA qui génèrent des centaines d’articles à la minute qui se ressemblent tous.</p><p>Et vous avez tort, car vous avez des choses à raconter ! Plein ! Et le plus simple est un sujet qu’une IA ne pourra jamais vous prendre : <strong>votre expérience</strong>.<br>Si aujourd’hui <strong>expliquer comment faire quelque chose de précis </strong>n’est plus vraiment utile, <strong>donner votre retour d’expérience</strong> <strong>sur divers sujets a bien plus de valeur</strong>.</p><p>Les IA peuvent nous rédiger à la volée des articles expliquant des concepts complexes, certes, mais <strong>elles ne pourront jamais donner leur propre ressenti aussi bien que nous. </strong>Quoi de plus humain que d’exposer un ressenti sur une anecdote <strong>vécue</strong> ?</p><p>C’est ceci qui démarquera vos articles de tous ceux générés par IA. <strong>Votre authenticité est désormais votre valeur ajoutée</strong>.<br>Et le plus beau : puisque c’est <strong>votre</strong> retour d’expérience, il sera forcément <strong>unique</strong>. Personne d’autre n’a pu écrire un article sur ce sujet !</p><p>Vous avez mis en place la <em>Clean Architecture</em> dans votre entreprise ? Vous avez migré un vieux projet de 15 ans sur <em>Next.js</em> ? Vous vous êtes préparé à un marathon alors que vous n’êtes pas un sportif ? Vous vous êtes lancé le défi de ne plus du tout manger de viande ?<br>Peu importe le sujet : vous n’êtes sans doute pas le seul dans le monde à l’avoir fait, mais <strong>votre expérience, les problématiques que vous avez rencontrées et l’apprentissage que vous en avez tiré sont uniques</strong>. Et ça peut intéresser d’autres personnes !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*QT10OTkIRXEizo3HdUWhIg.png" /><figcaption>“Le passé c’est douloureux mais, à mon sens, on peut soit le fuir, soit tout en apprendre !” (<strong><em>Le Roi Lion</em></strong>, 1994)</figcaption></figure><p>En bref : <strong>vous avez des choses à raconter.<br></strong>Alors n’hésitez pas, et faites-le !</p><h3>OK d’accord, mais je n’aime pas écrire. Je n’ai pas de “style”, je ne sais pas comment rédiger un article correctement.</h3><p>Parfois par manque de temps, souvent par une dévalorisation de sa propre compétence en écriture, les personnes qui ont des expériences à partager sont très souvent celles qui ne prennent pas le temps de les écrire.</p><p>Si vous êtes dans ce cas et que cet article vous a motivé malgré tout à rédiger le votre, je vous invite à consulter sa suite : <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-2-bc14e0b193ee"><strong>Écrire un article à l’ère de l’IA — Partie 2 : comment s’y prendre ?</strong></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ca87ef668ef4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ecrire-un-article-a-l-ere-de-l-ia-partie-1-ca87ef668ef4">Écrire un article à l’ère de l’IA — Partie 1</a> was originally published in <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie">Technologie @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Comment j’ai gagné $500 en développant un jeu avec Phaser…]]></title>
            <link>https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/comment-jai-gagne-500-dollars-en-developpant-un-jeu-avec-phaser-b8d9d531e0a5?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/b8d9d531e0a5</guid>
            <category><![CDATA[vibe-coding]]></category>
            <category><![CDATA[gamedevjs]]></category>
            <category><![CDATA[gamedev]]></category>
            <category><![CDATA[phaser-3]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Fri, 06 Jun 2025 14:24:58 GMT</pubDate>
            <atom:updated>2025-06-06T17:09:18.012Z</atom:updated>
            <content:encoded><![CDATA[<h4>… sans connaitre Phaser, mais grâce à l’IA !</h4><h3><strong>Contexte :</strong> une <em>game jam</em> pour tester de nouvelles choses</h3><p>Comme beaucoup de développeurs, j’ai tendance à avoir des tas d’idées de projets persos à côté de mon travail. Et comme beaucoup de développeurs, je n’ai pas la rigueur nécessaire pour les mener à terme…<br>C’est pourquoi j’aime participer à des <em>game jams</em> : avoir une date butoir pour terminer un projet est <strong>la</strong> clé qui manque à mes projets “libres”. Avec une date fixe, pas le temps de tergiverser : on doit aller à l’essentiel, on doit couper des idées, on doit finir un jeu même s’il n’est pas parfait !</p><p>En tant que développeur web, ma <em>game jam</em> favorite est la <a href="https://gamedevjs.com/">Gamedev.js</a> qui propose justement de créer des jeux avec les technologies du web. Chaque édition apporte également son lot de défis optionnels, avec différents lots à la clé.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/728/0*GshYpGdA_RLgX1y9.png" /></figure><p>En cette année 2025, l’un de ces défis optionnels demandait de <em>vibe </em>coder un jeu avec la librairie <a href="https://phaser.io/">Phaser</a> : autrement dit, utiliser l’IA pour développer un jeu avec Phaser.</p><p>Je n’avais <strong>jamais</strong> utilisé Phaser et me servir de l’IA pour construire tout un projet depuis zéro m’intriguait. Le CPTO d’OpenClassrooms, <a href="https://medium.com/u/068b93ca426b">Oualid Abderrazek</a>, a en plus annoncé <a href="https://medium.com/openclassrooms-product-design-and-engineering/entering-the-age-of-artificial-intelligence-6e245695b7bc">une approche “AI First”</a> pour notre entreprise.<br>Ce défi était donc pour moi l’occasion idéale de vraiment tester la puissance de l’IA dans un projet concret. Et pour rendre le challenge encore plus intéressant, je me suis imposé une règle simple : <strong>interdiction totale de lire le moindre tuto sur Phaser</strong>.<br>L’idée était vraiment de tout faire avec Copilot !</p><h3>Découvrez “This game is unbalanced!”</h3><p>La vaste majorité des <em>game jams</em> proposent un thème à suivre. Cette année, le thème était “BALANCE” (ou “équilibre” en bon français).</p><p>J’ai décidé de partir sur un jeu qui demande d’équilibrer le jeu en lui-même. J’imaginais des personnages virtuels parcourir des niveaux trop faciles ou trop difficiles pour eux, et au (vrai) joueur du jeu d’équilibrer ces niveaux pour qu’ils soient amusants.<br>J’avais en tête plusieurs profils pour les personnages virtuels - des débutants comme des aguerris — l’idée étant de mettre en avant à quel point il est difficile d’équilibrer un jeu pour le rendre amusant pour tout le monde.<br>Je n’ai pas pu mettre en place la totalité de ces idées : comme je le disais en introduction il est souvent nécessaire de modifier ses plans lorsqu’on participe à une <em>game jam</em> !</p><p>Quoi qu’il en soit, le jeu est aujourd’hui terminé. Il s’appelle <strong>“This game is unbalanced!”</strong> et il est jouable gratuitement ici : <a href="https://adrien-gueret.itch.io/this-game-is-unbalanced">https://adrien-gueret.itch.io/this-game-is-unbalanced</a> (attention, il y a du son au démarrage).</p><p><em>Spoiler alert :</em> mon jeu est arrivé <strong>premier </strong>dans la catégorie “innovation”, et <strong>premier </strong>dans le défi de <em>vibe coding</em> ! Ceci m’a permis de gagner quelques goodies sympathiques et les fameux $500 🤑</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9q1sY1PmVaCUdrtdiaKTGg.png" /><figcaption>Hey, c’est mon jeu en première place !</figcaption></figure><p>Le but de cet article est de vous expliquer comment j’ai développé ce jeu… ou plutôt comment j’ai <em>pair</em> programmé avec Copilot pour le réaliser.</p><h3>Par où on commence pour développer un jeu avec Phaser sans connaitre Phaser ?</h3><p>Motivé par ce nouveau projet, j’ai ouvert mon IDE, j’ai créé un nouveau dossier et… que faire ? Avec cette contrainte de ne pouvoir lire aucun cours, je me suis tout d’abord senti un peu perdu devant ce dossier vide. Je n’avais pas le choix, il me fallait déjà demander l’aide de Copilot !</p><p>Les premières lignes que j’ai écrites pour mon jeu sont donc littéralement celles-ci :</p><blockquote>Je veux faire un projet avec la librairie @phaserjs. Peux-tu me créer le template du jeu ?<br>Sache que je m’y connais un peu en création de jeu HTML/CSS/JS, mais je n’ai jamais utilisé Phaser.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/795/1*1DlgzHhFEHeQCogzaLs1MQ.jpeg" /><figcaption>Copilot m’a généré rapidement la structure d’un projet Phaser.</figcaption></figure><p>Première bonne surprise pour moi : il m’a généré toute l’arborescence du projet en un seul coup. Le code est commenté pour que je puisse comprendre ce qu’il a fait. Cerise sur le gâteau : il m’a même généré un jeu basique de plateformes !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/896/1*G9UrpeejKDQ4lGGDiDJGEw.jpeg" /><figcaption>Ceci est la toute première image de mon jeu !</figcaption></figure><p>J’avais donc déjà un premier jet de jeu, avec une architecture de projet qui me paraissait propre, tout ça en moins de 1 minute et sans écrire une seule ligne de code moi-même !</p><h3>On a les bases d’un jeu, mais je ne voulais pas d’un jeu de plateformes !</h3><p>À ce stade j’avais déjà un peu l’impression de tricher… Mais vu que c’était tout le but du défi auquel je participais, je n’ai pas hésité à continuer ! Pour ma prochaine instruction à Copilot, je lui ai détaillé le concept du jeu :</p><blockquote>Super, merci beaucoup !</blockquote><blockquote>J’aimerais faire un jeu de réflexion. Voici le pitch :</blockquote><blockquote>- Chaque niveau représentera un niveau fictif d’un jeu fictif (ça peut être un niveau pour un jeu de plateforme, un jeu de course, un combat de Boss RPG…)<br>- Un joueur fictif va essayer de jouer à ce niveau fictif<br>- Il parvient à finir le niveau (ou pas !), et se plaindre que le niveau est trop facile ou trop dur (il est “unbalanced” quoi)<br>- Le niveau passe alors en mode “editor”. On arrive dans une interface qui permet de modifier le niveau.<br>- Le but du vrai joueur (celui qui joue à notre jeu !) est de modifier le niveau fictif pour répondre aux exigences du joueur fictif.</blockquote><blockquote>Est-ce que c’est clair déjà ?<br>Peux-tu m’aider à mettre ça en place ?</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/798/1*784_1FR_7rZ5n5QtJdqK4w.jpeg" /><figcaption>On donne les détails du jeu à Copilot. Notons qu’il est toujours sympa : il n’hésite pas à dire qu’il trouve le concept “très intéressant et créatif” !</figcaption></figure><p>Pour être honnête, <strong>je n’y croyais pas du tout</strong>. J’étais persuadé qu’il allait me générer un jeu qui allait planter au démarrage, ou un jeu bourré de bugs impossibles à corriger. Oui, j’avais quelques a priori sur l’IA !<br>En tout cas, avec cette instruction assez précise, le traitement de Copilot a été bien plus long que la précédente : <strong>il a pris environ 10 minutes pour générer le code</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/780/1*UMlI6pJJZi5aqBsfmMHKdg.jpeg" /><figcaption>Copilot me génère tout un tas de fichiers pour répondre aux besoins que je lui ai énoncés.</figcaption></figure><p>Copilot m’expliquait tout étape par étape, et notamment le but de chaque fichier qu’il me créait. Le nom des fichiers et la structure globale du projet qu’il me générait étaient plus ou moins ce que j’avais en tête lorsque je lui ai donné l’instruction, ce qui m’a quand même agréablement surpris (et un peu fait flipper aussi… 😬)</p><p>Et après 10 minutes donc, Copilot me dit qu’il a terminé :</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/796/1*uf4SNFKJ-qjsBwVjI_ab3g.jpeg" /><figcaption>Copilot a fini de tout générer. Le jeu serait-il déjà terminé ?</figcaption></figure><p>Pour rappel, le nombre de lignes de code que j’ai écrit jusque là est de <strong>zéro</strong>. <strong>Je m’apprête à tester un jeu codé 100% par l’IA.</strong><br>Avec la sensation d’être un aventurier partant explorer des terres inconnues, je lance mon navigateur pour voir ce qui a été généré par Copilot et…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/462/1*P2NWMxuTt9F33IKp03hQRA.jpeg" /><figcaption>Une erreur JS. Le jeu ne démarre juste pas.</figcaption></figure><p>Je ne suis pas surpris, mais quand même un peu déçu.</p><h3>Des premiers résultats malgré tout impressionnants</h3><p>À ce moment du projet (soit 20 minutes après avoir commencé !), j’avais encore l’ambition de <strong>tout</strong> faire avec Copilot : je lui ai donc simplement copié/collé l’erreur. J’ai également tenté une toute petite suggestion, histoire de ne pas avoir l’impression de ne rien faire du tout… C’est très bizarre d’être passif en “codant” son propre projet !</p><blockquote>main.js:20 Uncaught ReferenceError: LevelSelectScene is not defined at main.js:20.5.<br><em>Ne manque-t-il pas des choses ? Le fichier index.html est-il OK ?</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/771/1*h9HMueKnDaHUlumQYKr0-Q.jpeg" /><figcaption>Je ne sais pas si c’est grâce à ma suggestion, mais Copilot voit le problème !</figcaption></figure><p>L’IA corrige alors le souci <strong>en quelques secondes</strong>, et je peux donc enfin voir les premières vraies images de “This game is unbalanced!”.<br>Ce qui est assez dingue, c’est que <strong>tous </strong>les écrans générés sont restés dans la version finale du jeu. J’ai juste eu à les modifier légèrement pour qu’ils soient plus beaux et correspondent un peu mieux à mes attentes. J’ai notamment créé moi-même la plupart des éléments graphiques.</p><p>Ci-dessous quelques exemples “première version codée par l’IA” / “version finale dans le jeu adaptée par mes soins” :</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/875/1*9i8LSSXt0X1u9qakd9Tpxg.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*60X8RjlvhDTTZjVEUEzSYQ.png" /><figcaption>L’écran-titre du jeu. J’ai juste adapté le style graphique pour que ça corresponde plus à ce que j’avais en tête.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/833/1*QMqfIfjHY6giNsPtZqnafg.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/837/1*aT3mmafmMbuRD1xIAbq8NA.png" /><figcaption>Le tutoriel du jeu. Notez qu’à la base, je n’avais <strong>pas</strong> demandé à Copilot d’en mettre un : il l’a crée de lui-même et j’ai décidé de le garder ! Pour le coup, je n’ai pas changé grand chose à sa proposition initiale…</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/885/1*meKpnEuVdw-I7WRpyhIMMw.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/827/1*EGT-40F6eRlXnu-KDdzmsg.png" /><figcaption>L’écran de sélection du jeu est l’un de ceux qui a le plus changés. Notez que la première version de l’IA était 100% fonctionnelle, avec déjà les niveaux verrouillés.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/901/1*2oHT-6Qcg_UpLAgNyiwu6w.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/843/1*Ax6ha-nPdubpx7KO4_N7DA.png" /><figcaption>La différence parait importante ici, mais en vrai elle est principale graphique… J’ai juste remplacé les formes simples par des sprites de ma conception ! Notez les boutons “Passer” et “Accélération” de la version d’origine, absents de la version finale : j’aurais voulu les garder, mais ils faisaient planter le jeu…</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/850/1*-8eOT_9nEj3KlUmB5--L6A.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/832/1*-6tTu_dvV83Y6uWQYAW0sA.png" /><figcaption>L’écran où le joueur virtuel fait ses retours au “vrai” joueur. Là aussi, les différences sont principalement graphiques !</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/864/1*m6ucn8h6NSsWGjEx2ffTjQ.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/843/1*rBpVk6hkOqJZhU-5oKeZhQ.png" /><figcaption>L’écran de modification est également resté plus ou moins le même… J’ai juste décidé de supprimer l’aperçu qu’avait mis en place l’IA (il n’apportait pas grand chose, il était buggué et son code était incompréhensible 😅)</figcaption></figure><p>Exceptés quelques soucis graphiques et d’alignement évidents, les résultats étaient donc plutôt impressionnants… c’était exactement la boucle de <em>gameplay</em> que j’avais en tête !</p><h3>Coder avec l’IA : une histoire d’apprentissage</h3><p>C’est à partir de ce moment que j’ai commencé à regarder le code généré par Copilot. Si l’architecture du projet était globalement correcte à mes yeux, les fichiers étaient à mon sens trop gros. J’ai donc demandé à l’IA de retravailler un peu ça : elle a ainsi mis en place un “plan de refactorisation” :</p><blockquote>Dis-moi, le fichier GameScene est très gros. On devrait pouvoir le refactor et avoir un fichier dédié à chaque type de niveau, non ?</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/806/1*f1vfiWliX0MI0RBWaY9T1g.jpeg" /><figcaption>Copilot prépare son “plan de refactorisation”.</figcaption></figure><p>Copilot a ainsi commencé à refactor le code qu’il a écrit, selon mes faibles instructions. Notez en effet que je ne lui ai pas du tout indiqué comment je voulais que la refactorisation soit faite : j’aurais pu l’aiguiller et lui dire où placer les fichiers, mais non. L’IA a tout fait d’elle-même.</p><p>Enfin, jusqu’à ce qu’elle plante en plein milieu du processus :</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/776/1*mGabaOfFD-OVIWGuZqqbSA.jpeg" /><figcaption>Copilot s’est arrêté en plein milieu du refactor avec une erreur “No lowest priority node found”.</figcaption></figure><p>Après le lui avoir fait la remarque, il a repris le travail comme si de rien n’était… Pour arriver à un projet qui ne fonctionnait plus du tout ! La plupart des fichiers étaient corrompus, comme s’il y avait eu un <em>merge</em> raté entre plusieurs versions du code.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/620/1*nfpye7KboaRFYQcTIFxovw.jpeg" /><figcaption>Le code JavaScript n’était plus du tout valide suite au refactor de Copilot…</figcaption></figure><p>Heureusement, il suffit de dire à Copilot qu’il a corrompu les fichiers pour qu’il corrige tout ça… mais seul lui sait ce qu’il a fait exactement.<br>J’ai alors décidé de faire les refactor moi-mêmes, et ce pour deux raisons :</p><ol><li>Avoir un code un peu plus maintenable et facile à faire évoluer</li><li>Comprendre un peu comment fonctionne Phaser, quand même !</li></ol><p>J’ai alors analysé le code qu’il m’a écrit, lu ses commentaires et, surtout, <strong>je lui ai posé des tas de questions.<br></strong>“Quel est le but de cette ligne ?”, “Quelles sont les paramètres de cette fonction ?”, “Pourquoi a-t-on besoin d’appeler telle méthode ?”. Copilot m’a réellement servi de mentor et m’a tout expliqué !<br>Tant et si bien qu’après quelques heures de <em>pair programming</em> avec lui, j’avais non seulement fait la refactorisation tant attendue, mais je comprenais en plus la philosophie et le fonctionnement de Phaser. Sans m’en rendre vraiment compte, <strong>j’ai appris à utiliser Phaser, et ce sans lire aucun cours ni aucune documentation</strong>. Uniquement grâce à Copilot.</p><p>Plutôt impressionnant !</p><h3>Un système de traductions créé en 5 minutes</h3><p>Une fois l’architecture du projet à mon goût, j’ai décidé d’aller plus loin et de proposer le jeu en deux langues : français et anglais. <strong>Jusque là le code n’avait pas du tout était pensé pour gérer plusieurs langues</strong>, mais j’ai quand même demandé naïvement à Copilot :</p><blockquote>J’aimerais une solution d’internationalisation de l’app. Pour l’instant on affiche que du texte en français.<br>J’aimerais pouvoir proposer au joueur de choisir sa langue : soit français, soit anglais.<br>Comment faire ?</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/774/1*B22oLdLnJiSue13f72RryA.jpeg" /><figcaption>Cette nouvelle demande ne fait pas peur à Copilot qui propose un plan d’action en moins de deux minutes… !</figcaption></figure><p>Le plan d’action de l’IA était non seulement pertinent, mais en plus il a réussi à le mettre en place tout seul. Copilot avait juste oublié quelques textes par-ci par-là, mais rien de méchant.<br>Pour être honnête, je ne sais pas à quel point la refactorisation précédente a aidé, mais force est de constater que mon jeu était prêt à être traduit en un temps record (en tout cas bien plus rapidement que si je l’avais fait tout seul !).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/453/1*lNcicqpd37QzlKy3HNYvzA.jpeg" /><figcaption>Détail amusant : lors du processus de traduction en anglais, Copilot a lui-même changé sa propre langue en anglais pour me parler… !</figcaption></figure><h3>Lorsque Copilot ne parvient plus à nous aider…</h3><p>J’ai été tellement content de cette expérience réussie avec le système de traductions que j’ai voulu aller encore plus loin. Pour rappel, le but de “This game is unbalanced!” est de laisser le joueur équilibrer le jeu. Au tout début, j’avais en tête d’équilibrer des jeux de plateformes, de combats types RPG et de courses.<br>Pour ce dernier genre de jeu, je souhaitais un rendu à la <em>Super Mario Kart</em>, sur SNES. Pour ce faire il fallait simuler <a href="https://fr.wikipedia.org/wiki/Mode_7">le Mode 7</a> de la console, qui est en gros une technique de manipulation de l’image pour donner un effet 3D sur des éléments 2D.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/538/1*k1tpDvX94Gic1huBPtOYhw.png" /><figcaption>Dans “Super Mario Kart”, le Mode 7 déforme l’image 2D du circuit pour donner l’impression que les pilotes roulent dessus.</figcaption></figure><p>Je me disais que le Mode 7 devait être facilement possible avec une librairie comme Phaser couplée de l’aide de l’IA.<br>Hé bien… J’avais tort. J’ai eu beau tourner mes prompts dans tous les sens, essayer de lire des articles sur le Mode 7 pour mieux comprendre par moi-même, pas moyen d’y arriver :</p><ol><li>Je n’y comprenais rien</li><li>Copilot faisait n’importe quoi (il m’a même modifié le jeu de plateformes à un moment, parce que pourquoi pas ?)</li></ol><p>J’ai alors eu un sentiment étrange de vide et d’impuissance. <strong>Pour la première fois depuis le début du projet, Copilot ne m’était d’aucune aide</strong>. Que faire sans ce joker qui était déjà devenu une habitude ? Avais-je déjà perdu mes compétences de recherches sur StackOverflow ? N’étais-je finalement pas en train de vraiment tricher à force d’utiliser l’IA à la place de mon cerveau pour le moindre problème ?<br>Hé oui, <a href="https://medium.com/@adriengueret/docteur-je-suis-un-imposteur-afe8f302098f">le syndrome de l’imposteur</a> n’est jamais bien loin, et la sur-utilisation de l’IA sur ce projet me l’a renvoyé en pleine face !</p><p>Heureusement pour moi, je n’avais pas le temps de m’apitoyer : la date limite approchait, je devais trouver une solution !<br>Notre ancien CTO <a href="https://medium.com/u/3857c7ec7792">Romain Kuzniak</a> m’avait un jour dit :</p><blockquote>Avant de trouver une solution à ton problème, essaie de voir si tu ne peux pas supprimer le problème à la place. Comme ça, pas de solution à trouver !</blockquote><p>Et effectivement : avais-je vraiment besoin d’un jeu de courses en Mode 7 dans “This game is unbalanced!” ? Non, surtout en sachant qu’il restait moins de trois jours pour finir le jeu !</p><p>Je suis donc parti sur un jeu de type “Match 3”, bien plus simple à coder… en tout cas pour Copilot !<br>C’est en effet le seul type de jeu que je n’ai presque pas touché moi-même. <a href="https://github.com/adrien-gueret/this-game-is-unbalanced/blob/main/src/simulations/Match3Simulation.js">Le fichier correspondant</a> est d’ailleurs probablement le plus moche de tout le projet, avec plein de commentaires en franglais qui ne correspondent plus à rien, et près de 1500 lignes de code… Mais hé, ça fonctionne !</p><h3>Mais alors le “Vibe Coding”, c’est bien ? On doit tous s’y mettre ?</h3><p>Au début de ce projet, je ne connaissais pas du tout Phaser. J’ai pourtant réussi à créer un jeu complet contenant pas moins de trois types de mini-jeux différents. J’estime qu’environ 60% du projet a été généré par Copilot, et j’en ai modifié/amélioré 40%.</p><p>Et j’ai appris à utiliser Phaser au passage.<br>En me servant uniquement de Copilot.<br>Je trouve ça assez incroyable !</p><p>Mais pour contre-balancer un peu ce retour d’expérience (“balance” était le thème de la <em>game jam</em> après tout !), il est nécessaire de bien comprendre que je suis développeur web depuis plus de 12 ans maintenant. <strong>Je sais comment coder, je connais les bons <em>patterns</em> et je sais détecter les approximations lorsque l’IA essaye de me raconter n’importe quoi.</strong></p><p>Je ne suis vraiment pas sûr que cet outil puisse être aussi efficace pour un développeur junior qui débute. Ce dernier pourra sans doute commencer plus rapidement ses projets mais, sans être capable de comprendre le code généré, l’aide de l’IA risque de devenir bien vite contre-productive.</p><p>En fait, tout dépend de l’objectif de l’utilisateur de l’IA.</p><p>Si son objectif est d’apprendre et comprendre ce que l’IA génère, <strong>cet outil pourrait bien devenir le meilleur support pédagogique jamais créé.</strong></p><p>Mais si son objectif est juste d’accepter toutes les suggestions faites par l’IA, dans l’unique but de développer son application rapidement peu importe la qualité du code, alors <strong>cet outil pourrait bien être le meilleur générateur de code non maintenable jamais créé.</strong></p><p>À vous de voir où vous souhaitez placer le curseur !</p><p>Une chose est sûre en tout cas : l’outil fait désormais partie de notre quotidien, et il me semble absolument nécessaire d’être au minimum curieux sur son sujet.</p><p>Si vous avez aimé Potimonstre dans “This game is unbalanced!”, sachez qu’il est également présent dans un autre jeu de ma conception, “Motigma” !</p><p><a href="https://adrien-gueret.github.io/motigma/">Motigma</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/261/1*EaamlEeSbg4muTUsGFzHbw.png" /><figcaption><a href="https://adrien-gueret.github.io/motigma/">https://adrien-gueret.github.io/motigma/</a></figcaption></figure><p><em>(Malgré le thème de cet article, il n’a pas été rédigé avec l’IA, lui ! </em>😁<em>)</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b8d9d531e0a5" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/comment-jai-gagne-500-dollars-en-developpant-un-jeu-avec-phaser-b8d9d531e0a5">Comment j’ai gagné $500 en développant un jeu avec Phaser…</a> was originally published in <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie">Technologie @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Jean-Michel has broken the prod… again!]]></title>
            <link>https://medium.com/openclassrooms-product-design-and-engineering/jean-michel-has-broken-the-prod-again-b26541d3f51f?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/b26541d3f51f</guid>
            <category><![CDATA[development]]></category>
            <category><![CDATA[engineering]]></category>
            <category><![CDATA[bugs]]></category>
            <category><![CDATA[production]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 12 Dec 2022 09:34:21 GMT</pubDate>
            <atom:updated>2022-12-12T09:40:06.424Z</atom:updated>
            <content:encoded><![CDATA[<h4>Or how to play down with failed productions</h4><p>The way we handle releases evolves a lot during our career. When we start our developer life, and for some us even long after, pushing the big red button can be a little scary.</p><p>What if something goes wrong?<br>What if our code is not that perfect?<br>What if the whole site goes down <strong>because of us</strong>?! 😱</p><p>You have probably asked yourself these questions at least once, and maybe it’s still the case today. But… Why?</p><figure><img alt="Extrait de la scène d’introduction du jeu “Sonic Advance 3” dans laquelle on voit le personnage d’Eggman appuyer sur un gros bouton rouge." src="https://cdn-images-1.medium.com/max/480/1*PF5oIqArcQmMUWmxtflS-g.gif" /><figcaption>Why not having Eggman’s fluency when it comes to press the big red button? (introduction scene from “Sonic Advance 3”, Game Boy Advance)</figcaption></figure><p>The first reason is quite obvious: professional conscience. We want to do our job properly, and breaking production is the antithesis of this goal.</p><p>That said, this fear of releases seems to be more often present among junior developers. Does that mean seniors are less conscientious?<br>Of course not, but it would be a bit candid to say that seniors are simply more sure of themselves: more experience in the industry, meaning more sure of their skills, therefore less fear to push into production. This is undoubtedly true, sure, but it’s also way more complicated than that.</p><p>In addition to professional conscience, two other points can be scary when we break the production:</p><ol><li>the eyes of colleagues</li><li>the repair process in case of emergency</li></ol><p>Let’s take a few seconds to think about it… These two points should <strong>never</strong> be something to be afraid of, right?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*dKXNqm8mJEzL43PKLDv8HQ.png" /><figcaption>There’re so many things to legitimately be afraid of… (from the first movie trailer of “Sonic the Hedgehog”)</figcaption></figure><h4>Do you trust your colleagues?</h4><p>When the code we wrote breaks something, we can’t help but blame ourselves. This is <strong>our</strong> code, so it’s <strong>our</strong> fault. Right?</p><p>Wrong!</p><p>If your company follows the industry standards, you are probably not the only contributor of the code you push into production, even if you wrote it.</p><p>Perhaps this code has been the subject of a <a href="https://www.digiteum.com/technology-analysis-process/">technical analysis</a>. Perhaps you wrote it with a fellow colleague during a pair programming session.<br>You have most probably opened a pull request, where your code has been reviewed. Quality Engineers have tried to break everything while testing on staging environments, while automated tests must have checked a lot of things on their side.</p><p>In short, the point here is you are not the only responsible of the code you deploy into production: this is a team matter!</p><p><strong>When a bug is found in production, it’s never a one-person fault: the whole team has failed somewhere.</strong></p><p>It’s true that developers like to joke on each other. We love to say that “Jean-Michel has broken the production again”. We like to make fun of Jean-Michel, it can play down the situation while reassuring ourselves. But beware.<br>Maybe Jean-Michel is OK with that and happily laughs with you, but it can create an unhealthy atmosphere in your team despite of you. Developers unsure of their skills might be scared of finding themselves in Jean-Michel’s shoes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/1*3vWo8wdEptFtVA4_sIjLlw.jpeg" /><figcaption>Blaming each other does not effectively fix bugs. Work as a team! (from the movie “Sonic the Hedgehog 2”)</figcaption></figure><p>If joking on the subject is a good way to make people understand that no one dies because of a bug, we are not all sensitive in the same way. Just remember that.</p><p>The important thing is to set up a climate of trust in your team. <strong>Everybody should feel comfortable with making mistakes.</strong></p><p>As we say at OpenClassrooms: <em>“It’s OK to fail”</em>!</p><p>But keep in mind that breaking production is not trivial: it is not OK for your site to be unavailable for too long. It can have a big impact on the credibility and reputation of your product. In order to be comfortable with making mistakes, it’s required that fixes are easy and quick to apply.</p><p>So comes second point: your process to repair in an emergency.</p><h4>Do you trust your rollback process?</h4><p>When a release breaks something, it’s important to be able to react quickly and efficiently. What to do must be clear to everyone: notify the team, launch the rollback deployment, fix the faulty code… Whatever your process is, it’ll be followed in a hurry: that’s why it’s required to have a good documentation about it. Everybody must be comfortable with it!</p><p>If your team knows precisely what to do in case of production issues, the fear of breaking something will naturally decrease. Fear of the unknown is part of the most common ones, so make sure your rollback process is not scary!</p><p><strong>Playing down with failed productions is possible if, and only if, the rollback process is clear, efficient and not stressful.</strong></p><p>At OpenClassrooms, we trust our process so much we don’t hesitate <a href="https://medium.com/openclassrooms-product-design-and-engineering/do-not-deploy-on-friday-92b1b46ebfe6">to deploy on Friday</a>… What about you?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/498/1*ttk6kgzgshwx6WJC868OIw.gif" /><figcaption>A rollback going well, allegory (reversed gif from game “Sonic the Hedgehog”, Mega Drive)</figcaption></figure><h4>Well, OK, you broke the prod… So what?</h4><p>Just as a baker can burn a bread, or a painter can miss a brushstroke, a developer can write broken code.</p><p>It happens, it’s part of the job!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/498/1*AvoMTVBeUq35f9pZA7LeqQ.gif" /><figcaption>Come on, don’t blame yourself like that… (“Sonic Colours”, Wii)</figcaption></figure><p>For the most junior among us, please be aware that we all have made mistakes. Whether it’s me, this dear Jean-Michel, this colleague who impresses you, or even your CTO… We’ve broken an application in production at least once.</p><p>On my very first job, I sent a test email to all the clients of the company: using the production database instead of the staging one is a classic mistake and I made it only once in my life, trust me!</p><p>Another example, this time at OpenClassrooms: my own manager had broken the public API route serving our learning paths. And guess what? He’s now the engineering director of the company!</p><p><strong>Just because your code broke something doesn’t mean your career is over.</strong></p><p>But please don’t twist my words: breaking production is something to avoid. <strong>Making a mistake once in a while isn’t that bad, but repeating this same mistake is problematic.<br></strong>Please remember the following:</p><blockquote>The good thing about making mistakes is that you learn from them.</blockquote><p>So learn, learn while you can!</p><p>And be nice with Jean-Michel 😉</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BXfsB0cMcOWsCs4b6CKZXA.png" /><figcaption>And now… go push this big red button! (from the movie “Sonic the Hedgehog”)</figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b26541d3f51f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-product-design-and-engineering/jean-michel-has-broken-the-prod-again-b26541d3f51f">Jean-Michel has broken the prod… again!</a> was originally published in <a href="https://medium.com/openclassrooms-product-design-and-engineering">Product, Experience &amp; Technology @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Jean-Michel, il a encore cassé la prod !]]></title>
            <link>https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/jean-michel-il-a-encore-casse-la-prod-6362e4594b28?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/6362e4594b28</guid>
            <category><![CDATA[ingénierie]]></category>
            <category><![CDATA[production]]></category>
            <category><![CDATA[bugs]]></category>
            <category><![CDATA[development]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 12 Dec 2022 09:34:16 GMT</pubDate>
            <atom:updated>2022-12-12T09:40:48.034Z</atom:updated>
            <content:encoded><![CDATA[<h3>Jean-Michel, il a encore cassé la prod !</h3><h4>Ou comment dédramatiser les mises en prod ratées</h4><p>Le rapport que nous avons avec les mises en production semble beaucoup évoluer au fil de notre carrière : lorsqu’on débute le métier, et même parfois bien après, appuyer sur le gros bouton rouge peut donner des sueurs froides.</p><p>Et si quelque chose se passait mal ?<br>Et si notre code n’était pas si parfait ?<br>Et si le site tout entier tombait en rade <strong>par notre faute</strong> ?! 😱</p><p>Ces questions, vous vous les êtes sans doute déjà posées. Peut-être est-ce d’ailleurs toujours le cas aujourd’hui. Mais… pourquoi ?</p><figure><img alt="Extrait de la scène d’introduction du jeu “Sonic Advance 3” dans laquelle on voit le personnage d’Eggman appuyer sur un gros bouton rouge." src="https://cdn-images-1.medium.com/max/480/1*PF5oIqArcQmMUWmxtflS-g.gif" /><figcaption>Pourquoi ne pas avoir l’aisance d’Eggman lorsqu’il s’agit d’appuyer sur le gros bouton rouge ? (scène d’intro de “Sonic Advance 3”, Game Boy Advance)</figcaption></figure><p>La première raison est évidente : la conscience professionnelle. Nous voulons faire notre travail correctement et bien entendu que casser la production est l’antithèse de cet objectif.</p><p>Cela dit, j’ai constaté que cette crainte de mise en production est bien plus souvent présente chez les plus juniors. Cela signifie-t-il que les seniors ont moins de conscience professionnelle ?<br>Bien sûr que non, mais la réflexion un peu candide serait de se dire que les seniors sont simplement plus sûrs d’eux : plus d’expérience dans le milieu, donc plus sûrs de leurs compétences, donc moins de craintes pour mettre en prod. C’est sans doute vrai, mais c’est surtout plus compliqué que ça.</p><p>Outre la conscience professionnelle, deux points peuvent faire peur lorsqu’on casse la prod :</p><ol><li>le regard des collègues</li><li>le process pour réparer dans l’urgence</li></ol><p>Et si on prend un peu de recul… ce sont deux points que <strong>personne</strong> ne devrait craindre, vous ne croyez pas ?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*dKXNqm8mJEzL43PKLDv8HQ.png" /><figcaption>Il y a tellement d’autres choses que l’on peut légitimement craindre… (extrait de la première bande annonce du film “Sonic, le film”)</figcaption></figure><h4>Avez-vous confiance en vos collègues ?</h4><p>C’est plus fort que nous : lorsque le code qu’on a écrit casse quelque chose, on ne peut s’empêcher de s’en vouloir.<br>C’est <strong>notre</strong> code, c’est donc de <strong>notre</strong> faute. Vrai ?</p><p>Faux !</p><p>Si le process de votre entreprise suit la norme de ce qui se fait dans l’industrie, il est peu probable que vous êtes le ou la seule tributaire du code que vous avez mis en production, même si c’est vous qui l’avez écrit.</p><p>Peut-être votre code a-t-il en amont été le sujet d’une <a href="https://www.digiteum.com/technology-analysis-process/">analyse technique</a>, peut-être l’avez-vous écrit en <em>pair</em> avec un de vos collègues… <br>Il est sans doute passé sous le regard vigilant de ceux qui ont fait la <em>code review</em> de votre <em>pull request</em>. Des <em>Quality Engineers</em> ont sûrement essayé de tout casser lors de la phase de tests sur vos environnements de <em>staging</em>, tandis que des tests automatiques ont sans doute tout vérifier de leur côté.</p><p>Bref, le point ici est que vous n’êtes pas le ou la seul(e) responsable du code que vous déployez en production : c’est une affaire d’équipe !</p><p><strong>Lorsqu’un bug est détecté en production, ce n’est jamais la faute d’une seule et même personne : c’est l’équipe toute entière qui s’est ratée quelque part.</strong></p><p>Alors oui, les développeurs aiment bien se charier entre eux. On aime bien dire que “Jean-Michel a encore cassé la prod”. C’est rigolo de se moquer gentiment de Jean-Michel, ça peut dédramatiser la situation tout en se rassurant soi-même. Mais… attention.<br>Peut-être que Jean-Michel le prend bien et rigole volontiers avec vous, mais cela peut instaurer une ambiance malsaine malgré vous. Un développeur peu sûr de ses compétences pourrait être effrayé de se retrouver à la place de Jean-Michel.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/1*3vWo8wdEptFtVA4_sIjLlw.jpeg" /><figcaption>S’accuser les uns les autres ne permet pas de régler efficacement les bugs. Travaillez plutôt en équipe ! (extrait de “Sonic 2, le film”)</figcaption></figure><p>Si les taquineries sur le sujet sont un bon moyen de faire comprendre qu’il n’y a pas mort d’hommes et que casser la production n’est finalement pas si grave que ça, nous ne sommes pas tous sensibles de la même manière. Pensez-y.</p><p>L’important est d’instaurer un climat de confiance dans votre équipe. <strong>Il faut que tout le monde se sente à l’aise de faire des erreurs.</strong></p><p><em>“It’s OK to fail”</em>, comme on dit à OpenClassrooms !</p><p>Mais il faut garder en tête que casser la production ne reste pas anodin : il n’est pas acceptable que votre site soit indisponible trop longtemps, cela peut avoir de gros impacts sur la crédibilité et la réputation de votre produit. C’est pourquoi, afin de pouvoir être à l’aise sur l’idée de faire des erreurs, il est important que les corrections pour régler les problèmes soient faciles et rapides à appliquer.</p><p>Vient donc le point 2 : le process pour réparer dans l’urgence.</p><h4>Avez-vous confiance en votre système de rollback ?</h4><p>Lorsqu’une mise en production casse quelque chose, il est important de pouvoir agir rapidement et efficacement. Les actions à mener doivent être claires pour tous : prévenir l’équipe, lancer le déploiement de <em>rollback</em>, corriger le code défectueux… Peu importe votre process, il faut avoir en tête qu’il est généralement effectué dans l’urgence : il est donc primordial qu’il soit bien documenté, mais surtout bien dans la tête de tout le monde !</p><p>Si votre équipe sait précisément ce qu’il faut faire en cas de problèmes en production, la crainte de casser quelque chose sera naturellement amoindrie. La peur de l’inconnu est l’une des peurs les plus communes, alors faites en sorte qu’elle ne concerne pas votre processus de réparation de votre site !</p><p><strong>Ce n’est qu’avec un système de <em>rollback</em> clair, efficace et non stressant qu’il est possible de dédramatiser les mises en production ratées.</strong></p><p>À OpenClassrooms, on a tellement confiance en notre process qu’on n’hésite pas à <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/ne-d%C3%A9ploie-pas-en-production-un-vendredi-827c93ab2e93">déployer en production le vendredi</a>… Et chez vous ?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/498/1*ttk6kgzgshwx6WJC868OIw.gif" /><figcaption>Allégorie d’un rollback se passant bien (gif inversé venant du jeu “Sonic the Hedgehog”, Mega Drive)</figcaption></figure><h4>Bon, OK, vous avez cassé la prod… Et après ?</h4><p>Tout comme un boulanger peut brûler son pain, ou un peintre peut rater son coup de pinceau, un développeur peut écrire un code non fonctionnel.</p><p>Ça arrive, ça fait partie du métier !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/498/1*AvoMTVBeUq35f9pZA7LeqQ.gif" /><figcaption>Voyons, il ne faut pas s’en vouloir comme ça… (“Sonic Colours”, Wii)</figcaption></figure><p>Pour les plus juniors d’entre nous, sachez qu’on a tous fait des erreurs. Que ce soit moi, ce cher Jean-Michel, votre collègue trop fort qui vous impressionne, ou votre CTO… On a tous cassé une production au moins une fois dans notre vie professionnelle.</p><p>Lors de mon tout premier job, j’ai envoyé un e-mail de test à <strong>tous</strong> les clients de l’entreprise : confondre la base de <em>staging</em> avec celle de prod est une erreur classique et, croyez-moi, je n’ai fait cette erreur qu’une seule fois dans ma vie !</p><p>Autre exemple, à OpenClassrooms cette fois : mon propre manager avait cassé la route API publique retournant la liste de nos parcours. Et devinez quoi ? C’est aujourd’hui le directeur <em>engineering</em> de la boite !</p><p><strong>Ce n’est pas parce que votre code a cassé quelque chose que votre carrière est terminée.</strong></p><p>Mais ne me faites pas dire ce que je n’ai pas dit : casser la production reste quelque chose à éviter. <strong>Faire une erreur une fois de temps en temps n’est pas si grave, c’est répéter cette même erreur qui est problématique. </strong>Pensez au fameux dicton :</p><blockquote>C’est en faisant des erreurs qu’on apprend.</blockquote><p>Alors apprenez, apprenez tant que vous le pouvez !</p><p>Et soyez gentils avec Jean-Michel 😉</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BXfsB0cMcOWsCs4b6CKZXA.png" /><figcaption>Allez appuyer sur le gros bouton rouge maintenant ! (extrait de “Sonic, le film”)</figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6362e4594b28" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/jean-michel-il-a-encore-casse-la-prod-6362e4594b28">Jean-Michel, il a encore cassé la prod !</a> was originally published in <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie">Technologie @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[The real benefit of 100% code coverage]]></title>
            <link>https://medium.com/openclassrooms-product-design-and-engineering/the-real-benefit-of-100-code-coverage-b2f30393d659?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/b2f30393d659</guid>
            <category><![CDATA[engineering]]></category>
            <category><![CDATA[coverage]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[test-automation]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 22 Nov 2021 11:19:43 GMT</pubDate>
            <atom:updated>2021-11-24T13:30:19.570Z</atom:updated>
            <content:encoded><![CDATA[<h4>No, it isn’t only to be proud of ourselves!</h4><p>It’s normal today to test your codebase. Any company whose business is based on a technical solution has implemented an automated testing solution.</p><p>We’re all in agreement on that. Now the question is: “What should we test?”</p><p>In this article, we are <strong>not</strong> going to talk about the different types of tests. We’re not talking about <a href="https://openclassrooms.com/fr/courses/5661466-use-testing-in-java-to-achieve-quality-applications/6232336-use-the-testing-pyramid-to-choose-the-right-automated-tests">the difference between unit testing, integration testing, or end-to-end testing</a>. Instead, we’re going to talk about a much more controversial topic: test coverage.</p><p>And why a 100% code coverage is a good idea you should set up in your team.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cCn_MrR4RHycRbC1l4uNUg.png" /><figcaption>Isn’t it beautiful?</figcaption></figure><h4>Good coverage does not imply good tests</h4><p>Before starting, let’s be clear.</p><p>This is the most common point from 100%-coverage detractors: a covered code does not mean it’s well tested.</p><blockquote>It is better to have 50% of the project tested correctly, than 100% poorly tested.</blockquote><p>This is correct.<br>It’s useless, even counter-productive, to write tests only to write tests.</p><p>In this article, when we speak about covered code, we assume it’s correctly tested code.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/942/1*yJy6Zrv00Mb_M_Q08ZrX4A.png" /></figure><p>This argument, even if it’s valid, is off topic: as a reminder, the question here is “What to test?”, not “How to test?”</p><p>Now that’s clear, we can go back to the initial topic: 100% code coverage.</p><h4>Code coverage below 100% doesn’t lead to questioning</h4><p>Let’s imagine a project in which the code coverage limit is set to 80%. When running the test suites, all is green and the actual code coverage is 85%. Perfect!</p><p>Now imagine we need to develop a new feature. The developer in charge does their best and writes some tests.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/976/1*dRWB-7RXWBPUO33pphxrmQ.png" /></figure><p>Despite these new tests, the code coverage drops to 84.5%.</p><p>What’s the meaning of this lost half-point?<br>The new feature is probably not fully tested, but is it something to worry about? To know more, we need to analyse updated files; but some code already wasn’t fully covered, making the task harder. This research time is not motivating since, in any case, everything is green for the CI!</p><p>With a code coverage limit set to 80%, this information that coverage has dropped slightly<em> </em>is likely to be lost. Losing 0.5% is really not that much and, once again, all tests passed and the CI says everything is OK, without any warnings.<br>So why bother?</p><p>A coverage set below 100% leads to two things:</p><ul><li>loss of information;</li><li>less accountability.</li></ul><h4>A 100% code coverage is a safety net</h4><p>Let’s take the same situation, but this time with a code coverage limit set to 100%. The new feature is developed the exact same way with the exact same tests, only the code coverage limit differs.<br>After the development of the feature, the global code coverage still decreases, but this time the new value is 99.8%: everything is red and the merge is blocked.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Wkh3DTMF99lw3oInoodz3Q.png" /><figcaption>If tests are missing, the warning is crystal clear.</figcaption></figure><p>The warning is triggered, and we must therefore analyze why the coverage is no longer at 100%. Here, two cases are possible:</p><ol><li>We have forgotten to test an important scenario;</li><li>It’s something we consider useless to test.</li></ol><p>In the first case, we are glad to have been warned. We write the missing test, code coverage goes back to 100%, everything is green again and our application is more robust.</p><p>In the second case, rather than writing a useless test, we prefer at OpenClassrooms to ignore the corresponding lines.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kdmd4Eo5DDM-jc7CV8I9Jw.png" /><figcaption>Since everything is supposed to be green, files not fully covered are clearly visible.</figcaption></figure><h4>Don’t hesitate to ignore your code!</h4><p>The easy shortcut, when speaking about 100% code coverage, is to think we must test every <em>if</em> and every optional parameter.</p><p>No!</p><p>We have to use common sense, and only test what needs to be tested.</p><blockquote>A 100% code coverage does not mean that 100% of lines are covered, but that 100% of the code which must be tested is actually tested.</blockquote><p>At OpenClassrooms, this leads to multiple <em>/* istanbul ignore next */.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/466/1*ZpsfTzCp6qtGwwhJG8rLtA.png" /><figcaption>Without this option to skip code, the 100% coverage rate would be counterproductive.</figcaption></figure><p>Of course, the idea is <strong>not</strong> to ignore everything. When we add a new <em>ignore</em> in the code, we have to justify it when reviewing the pull request. When a piece of code is ignored, it’s always <strong>explicitly</strong> and <strong>intentionally</strong> ignored.</p><p>So yes, our “100% code coverage” is a falsy 100%.<br>We assume it.</p><p>Thanks to this “fake” 100%, we know that everything important is tested. We receive warnings when the coverage is not perfect, and ignored lines are clearly marked as such.<br>In short, we don’t lose any information.</p><h4>So, when do you start?</h4><p>That said, setting the coverage limit to 100% is not the same challenge in all projects. It’s obviously easier to set up on new or small projects. It’s another story on older or bigger projects – it can even be inappropriate.</p><p>At OpenClassrooms, on the frontend side, the 100% code coverage is set only on our small libraries, like our collection of UI components or our API client.<br>The main website, which will soon turn 10 years old, is not concerned by 100% coverage and will not be any time soon, because of all its legacy code.</p><p>As always with our job, this is a matter of pragmatism. There are no rules to blindly follow, we just have to do our best according to our needs and constraints.</p><p>In short: be pragmatic!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/972/1*6sA7yo4IdKFm9ozlaCfNvA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b2f30393d659" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-product-design-and-engineering/the-real-benefit-of-100-code-coverage-b2f30393d659">The real benefit of 100% code coverage</a> was originally published in <a href="https://medium.com/openclassrooms-product-design-and-engineering">Product, Experience &amp; Technology @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Le véritable intérêt de la couverture du code à 100%]]></title>
            <link>https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/le-veritable-interet-de-la-couverture-du-code-a-100-pourcent-d54d8b9ee617?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/d54d8b9ee617</guid>
            <category><![CDATA[development]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[test-automation]]></category>
            <category><![CDATA[coverage]]></category>
            <category><![CDATA[taux-de-couverture]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Mon, 22 Nov 2021 11:19:40 GMT</pubDate>
            <atom:updated>2021-11-24T13:33:47.451Z</atom:updated>
            <content:encoded><![CDATA[<h4>Non, ce n’est pas que pour avoir bonne conscience !</h4><p>Tester son code, c’est désormais une évidence dans notre métier. N’importe quelle entreprise dont le business est basé sur une solution technique a mis en place une solution de tests automatisés.</p><p>Ceci établi, la nouvelle question à se poser est : “Que tester ?”.</p><p>Dans cet article, nous n’allons <strong>pas</strong> parler des différents types de tests. Nous n’évoquerons pas la différence entre les <a href="https://openclassrooms.com/fr/courses/7159306-testez-vos-applications-front-end-avec-javascript/7332786-adoptez-la-methodologie-des-tests-unitaires">tests unitaires</a>, les <a href="https://openclassrooms.com/fr/courses/7159306-testez-vos-applications-front-end-avec-javascript/7332803-adoptez-la-methodologie-des-tests-d-integration">tests d’intégration</a> ou les <a href="https://openclassrooms.com/fr/courses/7159306-testez-vos-applications-front-end-avec-javascript/7332824-realisez-des-tests-end-to-end">tests End-to-End</a>. Nous allons plutôt parler d’un sujet bien plus polémique : la couverture de test.</p><p>Et pourquoi le <em>code coverage</em> à 100% est une bonne idée que vous devriez mettre en place dans votre équipe.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cCn_MrR4RHycRbC1l4uNUg.png" /><figcaption>C’est beau, n’est-ce pas ?</figcaption></figure><h4>Un code couvert ne veut pas dire qu’il est bien testé</h4><p>Avant de commencer, petit aparté important.</p><p>Ceci est en effet l’argument qui revient souvent de la part des détracteurs à la couverture à 100% : ce n’est pas parce que le code est entièrement couvert qu’il est bien testé.</p><blockquote>Il vaut mieux avoir 50% du projet testé correctement, que 100% mal testé.</blockquote><p>Hé bien… C’est tout à fait vrai.<br>Il est inutile, voire contre-productif, de tester son code juste pour le tester.</p><p>Dans cet article, lorsqu’on parlera de code couvert, nous partirons sur le principe qu’il s’agit de code correctement testé.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/942/1*yJy6Zrv00Mb_M_Q08ZrX4A.png" /></figure><p>Cet argument, tout aussi valide soit-il dans le fond, reste hors-sujet par rapport au propos initial : pour rappel la question traitée ici est “Que tester ?”, et non “Comment tester ?”.</p><p>Cela étant éclairci, nous pouvons revenir au sujet de base : le taux de couverture des tests à 100%.</p><h4>La couverture en dessous des 100% ne favorise pas la remise en question</h4><p>Imaginons un projet où la limite de couverture est définie à 80%. Nous lançons la suite de tests et le résultat est vert : tous les tests passent et le taux effectif est de 85%. Tout va bien !</p><p>Une nouvelle fonctionnalité est alors développée. La personne chargée de l’implémentation fait de son mieux et écrit quelques tests.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/976/1*dRWB-7RXWBPUO33pphxrmQ.png" /></figure><p>La couverture globale de l’application descend alors à 84.5%.</p><p>Que signifie ce demi-point perdu ?<br>Probablement que la nouvelle fonctionnalité n’a pas été complètement testée. Mais est-ce grave ? Pour le savoir il faudrait analyser les fichiers modifiés, mais ils n’étaient déjà pas entièrement couverts, ce qui complique un peu la tâche. Et ce temps de recherche n’est absolument pas motivant puisque, de toute façon, tout est vert pour la CI !</p><p>Puisque la limite est définie à 80%, l’information que la couverture a légèrement baissé a de grandes chances d’être perdue. Il est probable que personne ne se rende compte qu’on a perdu ces 0.5% : ce n’est vraiment pas grand chose, encore une fois les tests sont verts, et la CI dit que tout est OK sans lancer aucune alerte. <br>Alors pourquoi s’inquiéter ?</p><p>Ce qu’il faut noter ici, c’est qu<strong>’</strong>une limite de couverture en-dessous de 100% favorise deux choses :</p><ul><li>la perte d’information;</li><li>le sentiment d’être moins responsable.</li></ul><h4>La couverture à 100% est un filet de sécurité supplémentaire</h4><p>Prenons le même scénario, mais cette fois avec une limite de couverture définie à 100%. La nouvelle fonctionnalité a été codée de la même manière que précédemment, et les mêmes tests ont été écrits. <br>La couverture globale de l’application descend toujours, mais cette fois elle est à 99.8% : tout est rouge et on bloque la possibilité de <em>merger</em> la branche git correspondante.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Wkh3DTMF99lw3oInoodz3Q.png" /><figcaption>Lorsqu’il manque des tests, l’alerte est très visible.</figcaption></figure><p>L’alerte est lancée, il faut donc analyser pourquoi la couverture n’est plus à 100%. Ici, deux cas sont alors possibles :</p><ol><li>soit on a effectivement oublié de tester un cas important</li><li>soit c’est quelque chose qu’on estime inutile de tester</li></ol><p>Dans le premier cas, on est bien contents d’avoir été alertés. On écrit alors le test manquant, la couverture remonte à 100%, tout est vert et notre application en est plus robuste.</p><p>Dans le seconde cas, plutôt que d’écrire un test inutile, à OpenClassrooms nous préférons ignorer les lignes correspondantes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kdmd4Eo5DDM-jc7CV8I9Jw.png" /><figcaption>Puisque tout le reste est vert, les fichiers mal couverts ressortent bien.</figcaption></figure><h4>N’hésitez pas à ignorer votre code !</h4><p>L’amalgame évident quand on parle de couverture à 100%, c’est de croire qu’il faut tester le moindre <em>if</em> ou le moindre paramètre optionnel.</p><p>Non !</p><p>Il faut faire preuve de bon sens, et ne tester que ce qui doit l’être.</p><blockquote>Une couverture à 100% ne signifie <strong>pas</strong> que 100% des lignes de code sont couvertes, mais que 100% du code qui doit être testé l’est effectivement.</blockquote><p>Concrètement, chez nous cela se traduit par des <em>/* istanbul ignore next */ </em>parsemés ci et là.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/466/1*ZpsfTzCp6qtGwwhJG8rLtA.png" /><figcaption>Sans cette possibilité d’ignorer du code, le taux de couverture à 100% serait contre-productif.</figcaption></figure><p>Bien sûr, l’idée n’est <strong>pas</strong> d’ignorer tout par flemme. Lorsque nous ajoutons un <em>ignore</em> dans notre code, à nous de le justifier dans la <em>Pull Request</em>. Un code ignoré l’est donc toujours <strong>explicitement</strong> et <strong>volontairement</strong>.</p><p>Alors oui, notre <em>code coverage</em> à 100% est un “faux” 100%.<br>Nous l’assumons.</p><p>Grâce à ce “faux” 100%, nous avons malgré tout la certitude que tout ce qui est important est testé. Nous sommes alertés si nous passons sous ce seuil et le code ignoré par les tests est clairement indiqué… en bref nous n’avons aucune perte d’information.</p><h4>Alors, vous vous y mettez quand ?</h4><p>Cela dit, définir la limite de couverture à 100% n’est pas forcément évident selon les cas. Il sera bien entendu facile de le faire sur les nouveaux projets, ou les plus petits, mais migrer les grosses <em>codebases</em> existantes sera forcément assez compliqué, et peut-être même malvenu.</p><p>À OpenClassrooms, côté front-end, le taux de couverture à 100% est définie entre autres sur notre librairie UI et notre client API.<br>Le site principal, dont la version actuelle a déjà presque 10 ans, n’est pas concerné par le sujet et ne le sera pas tout de suite, étant donné le <em>legacy</em> qu’il comporte.</p><p>Comme souvent dans notre métier, tout est question de pragmatisme. Il n’existe pas de règles absolues à suivre aveuglément, faites simplement selon vos besoins et vos contraintes.</p><p>En bref, soyez pragmatique !</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/972/1*6sA7yo4IdKFm9ozlaCfNvA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d54d8b9ee617" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie/le-veritable-interet-de-la-couverture-du-code-a-100-pourcent-d54d8b9ee617">Le véritable intérêt de la couverture du code à 100%</a> was originally published in <a href="https://medium.com/openclassrooms-produit-design-et-ing%C3%A9nierie">Technologie @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[A front-end interview process at OpenClassrooms]]></title>
            <link>https://medium.com/openclassrooms-product-design-and-engineering/a-front-end-interview-process-at-openclassrooms-31d056258d5c?source=rss-6ecebb1962ab------2</link>
            <guid isPermaLink="false">https://medium.com/p/31d056258d5c</guid>
            <category><![CDATA[management]]></category>
            <category><![CDATA[people]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[interview]]></category>
            <dc:creator><![CDATA[Adrien Guéret]]></dc:creator>
            <pubDate>Thu, 10 Jun 2021 07:01:46 GMT</pubDate>
            <atom:updated>2025-10-21T13:31:40.188Z</atom:updated>
            <content:encoded><![CDATA[<p>During our professional life, going to interviews is a classic step we all go through. This is an event that has been the subject of a lot of articles, with a lot of tips to make it go as well as possible.</p><p>But what about the other side of the fence? What about conducting an interview?</p><p>After several years at OpenClassrooms, I had the opportunity to participate in a lot of job interviews. I would like to share our way of carrying out technical interviews for front-end developer positions.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*02L92DSHlNqrdX6eUs_hiA.png" /><figcaption>Do we size candidates up with a long, hard stare? (“The IT Crowd”, S1E1)</figcaption></figure><h3>First step: presentations</h3><p>Front-end interviews at OpenClassrooms are generally three-person meetings: two front-end developers meet the candidate. We avoid being too many in order to have a favorable context for the discussion without giving an impression of judgment.</p><p>This small number of people allows us to take a tour of the table to introduce ourselves. Our objective here is to create a pleasant atmosphere for the candidate, which helps to establish trust feelings.</p><p>When presentations are done, goals of the interview are specified: it’s clearly indicated that the idea is <strong>not</strong> to judge the candidate, but to simply have a discussion all together. The main objective, for us, is to know if their profile could match our needs and, for the candidate, to know if OpenClassrooms could fit their professional expectations. In short, we want to create the optimal conditions for success for the company as well as for the candidate.</p><p><strong>This first step lasts between 5 and 10 minutes</strong>, depending on the time taken by the candidate to present their career.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/416/1*ZZ7uDRkYGeU2evBffsbZ3A.jpeg" /><figcaption>Introducing ourselves is an essential step for building confidence. (“The IT Crowd”, S2E1)</figcaption></figure><h3>Second step: discussion and questions</h3><p>The important part of the interview is the discussion following the presentations. We have an internal document with a list of technical questions, <strong>but we avoid asking them as they are written</strong>. We use it as a common thread to guide the conversation, but we avoid as much as possible transforming the interview into an interactive quiz.</p><p>We prefer to follow up the candidate’s presentation to talk about the projects they have been involved in, ask for details on a few points, find out more about technical choices, etc. We also try to draw a parallel between what we hear and what we do at OpenClassrooms. An interview is a two-way street: it’s good to discuss our current issues so that the candidate can see what kinds of problems we face.</p><p>Sometimes, the discussion is so interesting that we forget we are holding an interview. When it turns into a real technical exchange between three people, that’s a pretty good sign!</p><p>However, “blanks” can also appear. That’s okay: our list of questions is here to jumpstart the conversation.</p><p><strong>This second step lasts between 40 and 50 minutes</strong>, depending on the subjects discussed.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/980/1*erg6IUn4vJUjR56O1MyruA.png" /><figcaption>A little chat is ideal for getting to know each other. (“The IT Crowd”, S2E4)</figcaption></figure><h3>Third step: technical exercise</h3><p>We do a technical exercise during our front-end interviews. It has one particularity that makes it interesting: <strong>it has no wrong answers</strong>.</p><p>We don’t ask to write a <em>merge sort</em> algorithm, we don’t ask questions about obscure design patterns, and we don’t require <a href="http://www.compciv.org/guides/python/fundamentals/fizzbuzz-challengehttp://www.compciv.org/guides/python/fundamentals/fizzbuzz-challenge">a “FizzBuzz” type exercise</a>. We prefer to ask the candidate for <strong>something concrete, something we face on a daily basis at work</strong>: to evaluate and to criticize a web page.</p><p>This page, created for the occasion, is very simple and contains many small issues, whether technical or visual. We give the candidate about fifteen minutes to list them as much as possible, while insisting on the fact that these <strong>errors can be totally subjective</strong>. Feedback such as “I do not find this page very pretty” are welcome, as soon they’re justified.</p><p>This page contains so many issues that it isn’t possible to list them all, and we insist on this point to reassure the candidate. With this exercise, we are not really interested in the number of reported errors, but rather on which kinds of issues the candidate is focusing on. One will see contrast issues more easily, another one will focus more on SEO, and maybe a third will be more sensitive to accessibility.</p><p>Our front-end job today is so vast and it requires so many different skills that, once again, this exercise can’t have wrong answers. And it’s very interesting to know the strengths of our candidates!</p><p>I’d love to share the link to this exercise so that you can get an idea but… you can easily understand why I won’t do so 😉</p><p><strong>This step lasts between 20 et 25 minutes :</strong> 15 minutes where we leave the candidate alone to let them analyze the page, and 5 to 10 minutes where we discuss the issues they have identified.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0MDJ293gFLeSx1VAgtNioQ.png" /><figcaption>Asking the candidate to analyse something is very instructive. (“The IT Crowd”, S4E5)</figcaption></figure><h3>Fourth step: candidate’s questions</h3><p>Even if we try to explain our work at OpenClassrooms during the discussion, it’s very likely that the candidate will have some questions on specific points.</p><p><strong>This last step lasts between 5 and 10 minutes</strong>, depending on how much time we have left.</p><p>It’s never easy to know if the format of an interview is good or not. That’s said, we’ve often had really good feedback on ours, so we think we’re going in the right direction.</p><p>Anyway, here’s one thing that doesn’t lie: our frontend colleagues stay with us longer than the market average. This is the best proof that profiles we hire are perfect fits for our team. I like to think that the way we conduct interviews has something to do with it!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YjGLz4cXW7rDW75kJfIBAA.png" /><figcaption>Nothing like an interview that ends well! (“The IT Crowd”, S1E1)</figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=31d056258d5c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/openclassrooms-product-design-and-engineering/a-front-end-interview-process-at-openclassrooms-31d056258d5c">A front-end interview process at OpenClassrooms</a> was originally published in <a href="https://medium.com/openclassrooms-product-design-and-engineering">Product, Experience &amp; Technology @ OpenClassrooms</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>