From cbc8b5c7c5e265c2e5a48ff240fc551431f71c0c Mon Sep 17 00:00:00 2001
From: julien <julien.deb@netig.net>
Date: Thu, 8 Oct 2026 21:05:59 +0200
Subject: [PATCH] Ajoute les commentaires et la documentation RDoc

---
 doc/README_md.html         |  43 ++++++++++++++++++++++++++++++++++++-
 doc/created.rid            |   6 +++---
 doc/js/search_index.js     |   2 +-
 doc/js/search_index.js.gz  | Bin 1263 -> 1327 bytes
 doc/table_of_contents.html |   3 +++
 5 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/doc/README_md.html b/doc/README_md.html
index b43481d..f5ad076 100644
--- a/doc/README_md.html
+++ b/doc/README_md.html
@@ -8,7 +8,7 @@
 <title>README - RDoc Documentation</title>
 
   <meta name="keywords" content="ruby,documentation,README">
-  <meta name="description" content="README: # Écarté">
+  <meta name="description" content="README: Écarté Implémentation en Ruby du jeu de l&#39;Écarté. Le projet est développé progressivement au fur et à mesure de mon apprentissage de Ruby, avec pour ">
 
 
 <script type="text/javascript">
@@ -64,6 +64,28 @@
   </div>
 
   
+<div class="nav-section">
+  <h3>Table of Contents</h3>
+
+
+
+  <ul class="link-list" role="directory">
+              <li>
+            <details open>
+              <summary>      <a href="#label-C3-89cart-C3-A9">Écarté</a>
+</summary>
+              <ul class="link-list" role="directory">
+                          <li>      <a href="#label-Documentation">Documentation</a>
+          <li>      <a href="#label-Lancer+le+jeu">Lancer le jeu</a>
+          <li>      <a href="#label-C3-89tat+du+projet">État du projet</a>
+
+              </ul>
+            </details>
+          </li>
+
+  </ul>
+</div>
+
   
 <div id="fileindex-section" class="nav-section">
   <h3>Pages</h3>
@@ -86,5 +108,24 @@
 
 <h1 id="label-C3-89cart-C3-A9">Écarté<span><a href="#label-C3-89cart-C3-A9">&para;</a> <a href="#top">&uarr;</a></span></h1>
 
+<p>Implémentation en Ruby du jeu de l’Écarté.</p>
+
+<p>Le projet est développé progressivement au fur et à mesure de mon apprentissage de Ruby, avec pour premier objectif de permettre une partie à deux joueurs dans le terminal.</p>
+
+<h2 id="label-Documentation">Documentation<span><a href="#label-Documentation">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p>La documentation générée avec RDoc est disponible ici :</p>
+
+<p><a href="https://docs.netig.net/ecarte">docs.netig.net/ecarte</a>/</p>
+
+<h2 id="label-Lancer+le+jeu">Lancer le jeu<span><a href="#label-Lancer+le+jeu">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<pre class="ruby"><span class="ruby-identifier">ruby</span> <span class="ruby-identifier">main</span>.<span class="ruby-identifier">rb</span>
+</pre>
+
+<h2 id="label-C3-89tat+du+projet">État du projet<span><a href="#label-C3-89tat+du+projet">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p>Le jeu des plis est en cours d’implémentation. Les règles complètes de l’Écarté seront ajoutées progressivement.</p>
+
 </main>
 
diff --git a/doc/created.rid b/doc/created.rid
index 45c7f11..40d0f6a 100644
--- a/doc/created.rid
+++ b/doc/created.rid
@@ -1,8 +1,8 @@
-Thu, 08 Oct 2026 19:38:51 +0200
-/home/julien/src/ecarte/README.md	Tue, 06 Oct 2026 15:31:12 +0200
+Thu, 08 Oct 2026 21:05:51 +0200
+/home/julien/src/ecarte/README.md	Thu, 08 Oct 2026 21:05:03 +0200
 /home/julien/src/ecarte/lib/card.rb	Thu, 08 Oct 2026 19:34:18 +0200
 /home/julien/src/ecarte/lib/deck.rb	Thu, 08 Oct 2026 19:33:38 +0200
 /home/julien/src/ecarte/lib/game.rb	Thu, 08 Oct 2026 19:33:06 +0200
 /home/julien/src/ecarte/lib/player.rb	Thu, 08 Oct 2026 19:32:32 +0200
 /home/julien/src/ecarte/lib/terminal_ui.rb	Thu, 08 Oct 2026 19:37:44 +0200
-/home/julien/src/ecarte/main.rb	Thu, 08 Oct 2026 18:35:18 +0200
+/home/julien/src/ecarte/main.rb	Thu, 08 Oct 2026 19:41:38 +0200
diff --git a/doc/js/search_index.js b/doc/js/search_index.js
index 694a9e7..a32fdb9 100644
--- a/doc/js/search_index.js
+++ b/doc/js/search_index.js
@@ -1 +1 @@
-var search_data = {"index":{"searchIndex":["card","deck","game","player","terminalui","add_point()","change_dealer()","choose_card()","clear_hand()","deal()","debug_game()","determine_dealer()","display_trick_winner()","display_wrong_card()","draw()","game_winner()","new()","new()","new()","new()","other_player()","play()","play()","play_trick()","receive()","shuffle()","stock()","strength()","to_s()","valid_follow_card?()","readme"],"longSearchIndex":["card","deck","game","player","terminalui","player#add_point()","game#change_dealer()","terminalui#choose_card()","player#clear_hand()","game#deal()","terminalui#debug_game()","game#determine_dealer()","terminalui#display_trick_winner()","terminalui#display_wrong_card()","deck#draw()","game#game_winner()","card::new()","deck::new()","game::new()","player::new()","game#other_player()","game#play()","player#play()","game#play_trick()","player#receive()","deck#shuffle()","game#stock()","card#strength()","card#to_s()","game#valid_follow_card?()",""],"info":[["Card","","Card.html","","<p>Représente une carte à jouer avec sa valeur et sa couleur.\n"],["Deck","","Deck.html","","<p>Représente un paquet de cartes et gère son contenu.\n"],["Game","","Game.html","","<p>Gère le déroulement et les règles d’une partie d’Écarté.\n"],["Player","","Player.html","","<p>Représente un joueur, sa main et son score.\n"],["TerminalUI","","TerminalUI.html","","<p>Gère l’affichage et les saisies dans le terminal.\n"],["add_point","Player","Player.html#method-i-add_point","()","<p>Ajoute un point au joueur.\n"],["change_dealer","Game","Game.html#method-i-change_dealer","()","<p>Échange les rôles de donneur et de non-donneur.\n"],["choose_card","TerminalUI","TerminalUI.html#method-i-choose_card","(player)","<p>Demande au joueur de choisir une carte et la retourne.\n"],["clear_hand","Player","Player.html#method-i-clear_hand","()","<p>Vide la main du joueur.\n"],["deal","Game","Game.html#method-i-deal","()","<p>Distribue les cartes et pose la retourne.\n"],["debug_game","TerminalUI","TerminalUI.html#method-i-debug_game","(game)","<p>Affiche les informations de débogage.\n"],["determine_dealer","Game","Game.html#method-i-determine_dealer","()","<p>Simule une coupe pour déterminer quel joueur sera le donneur.\n"],["display_trick_winner","TerminalUI","TerminalUI.html#method-i-display_trick_winner","(player)","<p>Affiche le joueur ayant remporté le pli.\n"],["display_wrong_card","TerminalUI","TerminalUI.html#method-i-display_wrong_card","()","<p>Affiche un avertissement si le coup joué ne respecte pas les règles.\n"],["draw","Deck","Deck.html#method-i-draw","()","<p>Retire et retourne la dernière carte du paquet.\n"],["game_winner","Game","Game.html#method-i-game_winner","()","<p>Retourne le joueur ayant le meilleur score.\n"],["new","Card","Card.html#method-c-new","(value, suit)",""],["new","Deck","Deck.html#method-c-new","()",""],["new","Game","Game.html#method-c-new","(player_name1, player_name2)",""],["new","Player","Player.html#method-c-new","(name)",""],["other_player","Game","Game.html#method-i-other_player","(player)","<p>Retourne l’autre joueur.\n"],["play","Game","Game.html#method-i-play","()","<p>Joue une partie.\n"],["play","Player","Player.html#method-i-play","(card)","<p>Retire une carte de la main du joueur.\n"],["play_trick","Game","Game.html#method-i-play_trick","(lead_player, follow_player)","<p>Joue un pli.\n"],["receive","Player","Player.html#method-i-receive","(card)","<p>Ajoute une carte à la main du joueur.\n"],["shuffle","Deck","Deck.html#method-i-shuffle","()","<p>Mélange les cartes du paquet.\n"],["stock","Game","Game.html#method-i-stock","()","<p>Retourne les cartes restantes dans le talon.\n"],["strength","Card","Card.html#method-i-strength","()","<p>Retourne la force de la carte sous forme d’integer.\n"],["to_s","Card","Card.html#method-i-to_s","()","<p>Retourne une représentation de la carte sous forme de string.\n"],["valid_follow_card?","Game","Game.html#method-i-valid_follow_card-3F","(follow_player, lead_card, follow_card)","<p>Vérifie si le coup du second joueur respecte les règles.\n"],["README","","README_md.html","","<p>Écarté\n"]]}}
\ No newline at end of file
+var search_data = {"index":{"searchIndex":["card","deck","game","player","terminalui","add_point()","change_dealer()","choose_card()","clear_hand()","deal()","debug_game()","determine_dealer()","display_trick_winner()","display_wrong_card()","draw()","game_winner()","new()","new()","new()","new()","other_player()","play()","play()","play_trick()","receive()","shuffle()","stock()","strength()","to_s()","valid_follow_card?()","readme"],"longSearchIndex":["card","deck","game","player","terminalui","player#add_point()","game#change_dealer()","terminalui#choose_card()","player#clear_hand()","game#deal()","terminalui#debug_game()","game#determine_dealer()","terminalui#display_trick_winner()","terminalui#display_wrong_card()","deck#draw()","game#game_winner()","card::new()","deck::new()","game::new()","player::new()","game#other_player()","game#play()","player#play()","game#play_trick()","player#receive()","deck#shuffle()","game#stock()","card#strength()","card#to_s()","game#valid_follow_card?()",""],"info":[["Card","","Card.html","","<p>Représente une carte à jouer avec sa valeur et sa couleur.\n"],["Deck","","Deck.html","","<p>Représente un paquet de cartes et gère son contenu.\n"],["Game","","Game.html","","<p>Gère le déroulement et les règles d’une partie d’Écarté.\n"],["Player","","Player.html","","<p>Représente un joueur, sa main et son score.\n"],["TerminalUI","","TerminalUI.html","","<p>Gère l’affichage et les saisies dans le terminal.\n"],["add_point","Player","Player.html#method-i-add_point","()","<p>Ajoute un point au joueur.\n"],["change_dealer","Game","Game.html#method-i-change_dealer","()","<p>Échange les rôles de donneur et de non-donneur.\n"],["choose_card","TerminalUI","TerminalUI.html#method-i-choose_card","(player)","<p>Demande au joueur de choisir une carte et la retourne.\n"],["clear_hand","Player","Player.html#method-i-clear_hand","()","<p>Vide la main du joueur.\n"],["deal","Game","Game.html#method-i-deal","()","<p>Distribue les cartes et pose la retourne.\n"],["debug_game","TerminalUI","TerminalUI.html#method-i-debug_game","(game)","<p>Affiche les informations de débogage.\n"],["determine_dealer","Game","Game.html#method-i-determine_dealer","()","<p>Simule une coupe pour déterminer quel joueur sera le donneur.\n"],["display_trick_winner","TerminalUI","TerminalUI.html#method-i-display_trick_winner","(player)","<p>Affiche le joueur ayant remporté le pli.\n"],["display_wrong_card","TerminalUI","TerminalUI.html#method-i-display_wrong_card","()","<p>Affiche un avertissement si le coup joué ne respecte pas les règles.\n"],["draw","Deck","Deck.html#method-i-draw","()","<p>Retire et retourne la dernière carte du paquet.\n"],["game_winner","Game","Game.html#method-i-game_winner","()","<p>Retourne le joueur ayant le meilleur score.\n"],["new","Card","Card.html#method-c-new","(value, suit)",""],["new","Deck","Deck.html#method-c-new","()",""],["new","Game","Game.html#method-c-new","(player_name1, player_name2)",""],["new","Player","Player.html#method-c-new","(name)",""],["other_player","Game","Game.html#method-i-other_player","(player)","<p>Retourne l’autre joueur.\n"],["play","Game","Game.html#method-i-play","()","<p>Joue une partie.\n"],["play","Player","Player.html#method-i-play","(card)","<p>Retire une carte de la main du joueur.\n"],["play_trick","Game","Game.html#method-i-play_trick","(lead_player, follow_player)","<p>Joue un pli.\n"],["receive","Player","Player.html#method-i-receive","(card)","<p>Ajoute une carte à la main du joueur.\n"],["shuffle","Deck","Deck.html#method-i-shuffle","()","<p>Mélange les cartes du paquet.\n"],["stock","Game","Game.html#method-i-stock","()","<p>Retourne les cartes restantes dans le talon.\n"],["strength","Card","Card.html#method-i-strength","()","<p>Retourne la force de la carte sous forme d’integer.\n"],["to_s","Card","Card.html#method-i-to_s","()","<p>Retourne une représentation de la carte sous forme de string.\n"],["valid_follow_card?","Game","Game.html#method-i-valid_follow_card-3F","(follow_player, lead_card, follow_card)","<p>Vérifie si le coup du second joueur respecte les règles.\n"],["README","","README_md.html","","<p>Écarté\n<p>Implémentation en Ruby du jeu de l’Écarté.\n<p>Le projet est développé progressivement au fur et …\n"]]}}
\ No newline at end of file
diff --git a/doc/js/search_index.js.gz b/doc/js/search_index.js.gz
index 9557f0ccd7833d61667411f68f275984cd283833..eda80cbe12cbbc3bce42bdc92402ddd590d41711 100644
GIT binary patch
delta 1313
zcmV++1>XAa39kwUABzYGkLi&HA%8bO+uNc)2)b#oMFSL@HkVBxaHX-#L?TsEvbzWZ
z<eEq5t*0Ws_YL$Wd6LfXM<iuin-(x2jx?O#Z+^UED$~GJvCT`?vFzLI?ShLE{#abT
zUDyxTmb_gQOqGlEqJ-iNJ}TA#KH8eygTg}xs^NmwJx79-W!_3Iy44p*6@ObMD#%M<
zH7NH+N)0(lv~-QCa%8h4ak|4@U*)9AkycA0tK^!D$UDW0H~F3mG5N4pQdB`#so35e
zNNmh6U_bkm-4;}C9X2oMczm#i7*at2d}nRf+kUgD-MN#FLw5>9)ol&Y$y}Smj@7)(
zH?pqf-WdM96URyn`m6P#Mt_f<|L^SBx63q1bYpp(sc>;QO_~!k$(@liCNR1_$))2v
zk<j?gx!j)MnWh;7u}pHkoF<%jFE4$1=|Z50H&E8q^y~5n59V!x1q{zfk6$BzIGz|M
z#_kv_=3YPy8NEzkW8RF|G3;jmM9|@4BM~pRiytgt@JFXd+peiC`F~CO-3_#AIA{<Z
zWW9h4Mc`@pD|;<_P#N1nk!hBp8t7F99TA1>iF))>pqksol?5XH=rkujYuWET$|#*4
zO#-Xoqk>FJfpU>e^j_{$i){SSDV6)wT&f`}hl3(>8dO2jY80x5j}<-3Pw)REpIX$#
z!H~lTQal{Ij$eG);D67aXYHq;^lD8(Xc!kJ9%#5OqyjJUR|nYNuC0_npL79@Vw(-e
zdaS@Zpc&Vk9AH9|lfDMLim{$Yt5frr4Rl*sUhs>U(*Oe%KSnQHI_OKrdgqrHpY#S7
z{x}Ok{FKwHz%ZLHE*<}vY+wc?R-}ayQbLLg_a<l_8&49s<9{&5HpF*Uw$Pj%SI}U$
zg5aWo-d19GRRnhmJIfSwvR7hEWN3E}hB;yNL3qJYS?!QgPJ>J_n~kkw@Y1e0wgP_F
z+n9#(Y0>#p)`uqi*^x}Htmx?xV*qM3Q&&+9>$ns)r^De+RtVmpIPLTgIC;eE9e&Om
ztZSPk*|%86l7I3y9NZ0+VK1qDUNtCY`aue)Q)A`x<8k_O3b7CyZwk9-SXBy|R#K~>
zFKx}I7KI`9pY2Jmt|oS1S!2`2hNrb{ikg!J6hbl(?ZJR5&@B`lwMHGc%+W}krmmmI
zZ9Ou@GI-@T&~atz$it8zS%MPWbU9mQSOazdcs0?Oo_|G2$`>hhswSaFx&dCBiIucw
z9O`Ze#<S4tDK6~y6%M-|u*vtlbF<W6Jr|Ji>V*HCOC!I9QZA6;%XJn}Uri*<^`B9i
za3yQ*#Y@X<bSI1{yhD&_Q1!TtO!^pc&x&^pK5IYW?JP{?iJ18|>qQatQ{;tSKG$<Y
zH9u(a$bYuN)?T{ktTVT0B_VPi#YOJcyayc$e6dgCfR5I&vp%^6a<*CnkI%xh;ZTnQ
z+6|MV@-(aHY@|HLiIN<}Vz242D&uvA;lG-o#4flqg-LowrejqMv!V*0c^fe;drhw!
zyY}Il0~L%hqZN8qpJO=E)tlbwS3)xc&#FZVF@Gc~uk?6RpAGF1`^DEkl1T{y*O@^l
zeIBtH0qF%U$9#jUZ!`li%NlUgE`84&XTga%aP#Ex)w3sdWwqzLnf!t98}&<p#C6lw
z!=V{t10uWW@9qt1p*NvQmvFrEGqwUHU*qgRpwN8ZK`q-B2Nk}q&^nD3VkQ}GaT~im
XeiC~BH(B`V-MfDQ46u!`*AM^zN~wN?

delta 1248
zcmV<61Rwja3hxO9ABzYGE7g$(A%7j9?QPK?1l=@9fdIv(&1D-1Txl$`kw}%4)(wIH
zz2*^m>oLCP4fG~?lFsl)Bqdv$7BC==G@RdWetgeVrh%#Ake94u*|*u-6&EG^xw?A0
zvLBvV@^)1)Rj#(H5{lROs8|E|XlwQc6dpQI4HvBLITEZa^Hy@vZN5ONIDarvL0$r@
zLAf_lYRE~VrE64`Bbz0O(;e>mDkoKrv|18bCD&v`-YH(Z&W~J($%mtoq6)f7#g67c
zVq<;*$Hk}Y4xn=Duz5kp`N0}uNCgG(duzKs^!t77&Yg4|x>F#k?qG;c=Gq+YS<TCQ
zFY8(!jp5%raje9kzuK;9^nd8Z|IUtmyH1ltH`en^g^TNH(wvw{?u?u<fzkCzE*;;Q
zgvNI+<@OBEG|d=@b&~7#G~vX1b>-7b7Xn4RfwHcqU)M7{n70WQFgznYevJU)cw(Fw
zyJN7JdjT<I^g4l!c{5_iuwMWWL5GXIM7-Rtez1VSADtc@x~8_|H-GJSH_)o#q(O9$
z^#U>!fv4f0?04CN%Gf;=nPwTPfnH_M5mCsVs7JpERCBw!wm`%motDIBE&HQK8Ku*s
zNnka6P>^XUP%g5G-phSzk&Qn(rE;H|OEqNWa8hJWgDOZ`jY8G%p`vH`>94=ZrxtZ_
zFy!!_6b~n_<7Zzs_<ytKMf)izz1mU`8pef*2O6#mslbc;#R2x$XI4s}&$@s{vHhN7
zJyzfy(2Q$N4ltp~NnZnA#aPdy)v5XG2D*bRcYGIf8epK}$LNJi2Yty{@BH%OliuLM
zA7>$mpK^K?7-sXurQ@T?24+BFMOqjkC8XH7H$n5*c#_D?!+#jt5Z~F@LUVRpLxbH4
zf{O-v2Z`ZT5!@;4EK|_QUWqZ0q1`<g=7iM;;U!09wL?ld4Kl@SF}9AuOS|US3iw@b
zV;ah*Md#01ADZxIM>4sxp{GZT0jSkXT}3sl<5Jk14yQX=A$Wu0w9`M}<c!%n{DL=F
z*EUPCZ?TLe<$rHDxf?3OUQ+wKYEaDdgA`Eb#>(f%<NW0mVj(u(6!wN;RVip%Nv(#y
zv^Aev6o%M;wkNr|nb?74jZGUHp4PT0YEBkV2+2US2Lq}=w@`G{8g<+<M<a2Xx_%zF
z^~e;<;FaG%$Carg4?}`v2}*F&<!qT@4cGzT)kI@@5q~8qU!>HjnuH$d26$~IR??br
zsJkH;&qA-K*xBzJ9Ckfmlka)wW~sk=DInw33I8RRMt%#WTp+`j+bp8Knn+seKch6^
zO4i(qmzKroP8d^ohal6S>Tw&H^fBUI6z>>()_%g<S(wTbG0Sb%iz4W!$P2xEspp1j
ze$e8PZGVHUy>!vpW^U0+LgYM(i`=bw4>}b1VxPtV9j#**eR2!rVzmYypM~ecsU8Qk
z8z!^zG^^-hq&&x&k{rciuj#NV<8_ANznY-LF1QPYNqR=6xhjTPQH9UEjhL3brq_*K
z`*6*H3dWex3caY$G0b%Jrg!?4&<w$gYLP+=iBZZcop0)kp`EeszW$L+N)Wis3_9ua
zh|LH{FL62Mdt7~^8Gu>VfSY#dd*(O`&dh<ECy%e6Kd~#TJ?G8j4}{;S>Bg&f@BRg+
KgH8@-5C8yE`*&mj

diff --git a/doc/table_of_contents.html b/doc/table_of_contents.html
index 823e1e9..3508a15 100644
--- a/doc/table_of_contents.html
+++ b/doc/table_of_contents.html
@@ -82,6 +82,9 @@
 
     <ul>
       <li><a href="README_md.html#label-C3-89cart-C3-A9">Écarté</a>
+      <li><a href="README_md.html#label-Documentation">Documentation</a>
+      <li><a href="README_md.html#label-Lancer+le+jeu">Lancer le jeu</a>
+      <li><a href="README_md.html#label-C3-89tat+du+projet">État du projet</a>
     </ul>
   </li>
 </ul>