WIP Translation codecoverage-analysis:40,test-doubles.xml:149

Author: Brice Favre

src/6.1/fr/README.md

@@ -21,6 +21,7 @@ Attention, la documentation est en cours de traduction (cf. tableau ci dessous)
  * Mettre à jour les fichiers existants
  * Partir à la chasse aux typos et aux fautes d'orthographes, de grammaire et de syntaxes
  * Détecter le franglais et les anglicismes
+ * Revue de pair sur les PR
 
 
 ## Plan
@@ -31,7 +32,7 @@ Attention, la documentation est en cours de traduction (cf. tableau ci dessous)
 | assertions.xml                    | NOK       |                |
 | bibliography.xml                  | NOK       |                |
 | book.xml                          | NOK       |                |
-| code-coverage-analysis.xml        | NOK       |                |
+| code-coverage-analysis.xml        | En cours  | @brice         |
 | configuration.xml                 | NOK       |                |
 | copyright.xml                     | NOK       |                |
 | database.xml                      | NOK       |                |

src/6.1/fr/code-coverage-analysis.xml

@@ -4,25 +4,41 @@
   <title>Analyse de couverture de code</title>
 
   <blockquote>
-    <attribution>Murali Nandigama</attribution>
+    <attribution>Wikipedia</attribution>
     <para>
-      La beauté du test ne se trouve pas dans l'effort mais dans l'efficience.
-    </para>
-    <para>
-      Savoir ce qui doit être testé est magnifique, et savoir ce qui est testé
-      est magnifique.
+      La couverture de code (en anglais : code coverage) est une mesure utilisée
+      en génie logiciel pour décrire le taux de code source testé d'un programme.
+      Ceci permet de mesurer la qualité des tests effectués.
+
+      In computer science, code coverage is a measure used to describe the
+      degree to which the source code of a program is tested by a particular
+      test suite. A program with high code coverage has been more thoroughly
+      tested and has a lower chance of containing software bugs than a program
+      with low code coverage.
     </para>
   </blockquote>
-
   <para>
     <indexterm><primary>Couverture de code</primary></indexterm>
+    <indexterm><primary>Xdebug</primary></indexterm>
 
     Dans ce chapitre, vous apprendrez tout sur la fonctionnalité de couverture
     de code de PHPUnit qui fournit une vision interne des parties du code de 
-    production qui sont exécutées quand les tests sont exécutés. Cela aide à
-    répondre à des questions comme :
+    production qui sont exécutées quand les tests sont exécutés. Elle utilise le composant
+    <ulink url="https://github.com/sebastianbergmann/php-code-coverage">PHP_CodeCoverage</ulink>
+    qui tire parti de la fonctionnalité de couverture de code fournie par l'extension
+    <ulink url="http://xdebug.org/">Xdebug</ulink> de PHP.
   </para>
 
+  <note>
+    <para>
+      Xdebug n'est pas distribué au sein de PHPUnit. Si une notice indiquant que
+      l'extension Xdebug n'est pas chargé en lançant les tests, cela signifie que
+      Xdebug n'est pas installé ou n'est pas configuré correctement. Avant de pouvoir
+      utiliser les fonctionnalités de couverture de code dans PHPUnit, vous devez lire
+      <ulink url="http://xdebug.org/docs/install">le guide d'installation de Xdebug.</ulink>.
+    </para>
+  </note>
+
   <itemizedlist>
     <listitem>
       <para>

src/6.1/fr/installation.xml

@@ -58,30 +58,30 @@
       <literal>php.ini</literal>:
 
       <screen>
-        suhosin.executor.include.whitelist = phar
-      </screen>
+suhosin.executor.include.whitelist = phar
+</screen>
     </para>
 
     <para>
       To globally install the PHAR:
     </para>
 
     <screen>
-      <prompt>$</prompt> <userinput>wget https://phar.phpunit.de/phpunit-6.1.phar</userinput>
-      <prompt>$</prompt> <userinput>chmod +x phpunit-6.1.phar</userinput>
-      <prompt>$</prompt> <userinput>sudo mv phpunit-6.1.phar /usr/local/bin/phpunit</userinput>
-      <prompt>$</prompt> <userinput>phpunit --version</userinput>
-      <computeroutput>PHPUnit x.y.z by Sebastian Bergmann and contributors.</computeroutput>
+<prompt>$</prompt> <userinput>wget https://phar.phpunit.de/phpunit-6.1.phar</userinput>
+<prompt>$</prompt> <userinput>chmod +x phpunit-6.1.phar</userinput>
+<prompt>$</prompt> <userinput>sudo mv phpunit-6.1.phar /usr/local/bin/phpunit</userinput>
+<prompt>$</prompt> <userinput>phpunit --version</userinput>
+<computeroutput>PHPUnit x.y.z by Sebastian Bergmann and contributors.</computeroutput>
     </screen>
 
     <para>
       You may also use the downloaded PHAR file directly:
     </para>
 
     <screen>
-      <prompt>$</prompt> <userinput>wget https://phar.phpunit.de/phpunit-6.1.phar</userinput>
-      <prompt>$</prompt> <userinput>php phpunit-6.1.phar --version</userinput>
-      <computeroutput>PHPUnit x.y.z by Sebastian Bergmann and contributors.</computeroutput>
+<prompt>$</prompt> <userinput>wget https://phar.phpunit.de/phpunit-6.1.phar</userinput>
+<prompt>$</prompt> <userinput>php phpunit-6.1.phar --version</userinput>
+<computeroutput>PHPUnit x.y.z by Sebastian Bergmann and contributors.</computeroutput>
     </screen>
 
     <section id="installation.phar.windows">

src/6.1/fr/test-doubles.xml

@@ -145,6 +145,19 @@ class StubTest extends TestCase
 ?>]]></programlisting>
     </example>
 
+    <note>
+      <title>Limitation: Méthodes nommées "method"</title>
+
+      <para>
+        The example shown above only works when the original class does not
+        declare a method named "method".
+      </para>
+
+      <para>
+        If the original class does declare a method named "method" then <literal><![CDATA[$stub->expects($this->any())->method('doSomething')->willReturn('foo');]]></literal> has to be used.
+      </para>
+    </note>
+
     <para>
       "Derrière la scène", PHPUnit génère automatiquement une nouvelle classe qui
       implémente le comportement souhaité quand la méthode <literal>getMock()</literal>