commentaires
############

Les commentaires sont là pour fourni des informations, explications au lecteur afin de lui faciliter la compréhension de ce qu’il lit.

avant
*****

.. code-block:: javascript

   function pile_ou_face ( probabilite_pile ) {
     var nombre_au_hasard = Math.random();
     if ( nombre_au_hasard < probabilite_pile ) {
       return('pile');
     } else {
       return 'face';
     }
   }

   console.log( pile_ou_face(0.5) );

après
*****

.. code-block:: javascript

   function pile_ou_face ( probabilite_pile ) {
     /* Renvoie 'pile' ou 'face' avec une probabilité donnée Nombre (de 0 à 1) -> Chaîne de caractères */

     // on prend un nombre aléatoire entre 0 et 1
     var nombre_au_hasard = Math.random();

     // s’il est inférieur à la probabilité donnée, on renvoie pile, et sinon face
     if ( nombre_au_hasard < probabilite_pile ) {
       return('pile');
     } else {
       return 'face';
     }
   }

   console.log( pile_ou_face(0.5) );