[iagno] Rework help main page.

[Arnaud B. <arnaudb src gnome org>]

commit fccecc65b7c3753fbb94488d381cb4f5d2d202f8
Author: Arnaud Bonatti <arnaud bonatti gmail com>
Date:   Sat Feb 1 12:54:19 2020 +0100

    Rework help main page.

 help/C/change-color.page |  2 +-
 help/C/index.page        | 19 +++++++++++++++----
 help/C/rules.page        |  2 +-
 help/C/strategy.page     |  2 +-
 help/meson.build         |  2 +-
 5 files changed, 19 insertions(+), 8 deletions(-)
---
diff --git a/help/C/change-color.page b/help/C/change-color.page
index 09b200c..b3db557 100644
--- a/help/C/change-color.page
+++ b/help/C/change-color.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="change-color">
   <info>
-    <link type="guide" xref="index#tips" />
+    <link type="guide" xref="index#play" />
     <revision version="0.1" date="2012-03-08" status="final"/>
     <revision pkgversion="3.34" version="0.2" date="2020-01-03" status="final"/>
 
diff --git a/help/C/index.page b/help/C/index.page
index 8c1c24f..7a77811 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -1,18 +1,23 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="guide" style="task"
-      id="index">
+      id="index"
+      xmlns:its="http://www.w3.org/2005/11/its";> <!-- the "its" line is allowing translations for medias -->
 
   <info>
     <title type='link' role="trail"><media type="image" src="figures/logo.png" its:translate="no"/></title>
     <title type='link'>Reversi</title>
     <title type='text'>Reversi</title>
-    <revision pkgversion="3.4" version="0.1" date="2012-03-08" status="final"/>
+    <revision pkgversion="3.36" version="0.2" date="2020-02-01" status="final"/>
 
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
     </credit>
+    <credit type="editor copyright">
+      <name>Arnaud Bonatti</name>
+      <email>arnaud bonatti gmail com</email>
+      <years>2020</years>
+    </credit>
 
     <license>
       <p>Creative Commons Share Alike 3.0</p>
@@ -21,12 +26,18 @@
 
   <title><media type="image" src="figures/logo32.png" its:translate="no"><span its:translate="yes">Reversi 
logo</span></media> Reversi</title>
 
-  <p><app>Reversi</app> is a boardgame played on an 8X8 grid with 64 pieces, dark on one side and light on 
the other. When a piece is captured it is turned over to join the capturing player's forces; the winner is 
the player with the most pieces of their color at the end of the game.</p>
+  <p><app>Reversi</app> is a boardgame played with pieces dark on one side and light on the other. 
<em>Dark</em> and <em>Light</em> play one after each other by adding on an empty tile a new piece of their 
color, trapping at least one opponent row of pieces; when pieces are captured that way, they are turned over 
to join the capturing player's forces. See <link xref="rules">reversi rules</link> to discover more about the 
game.</p>
+
+  <p><app>Reversi</app> allows you to play both the Classic version of reversi, where you try to dominate 
the board at the end, and the Reverse one, where the goal is to finish with <em>less</em> pieces than your 
opponent. You can play both either <link xref="ai-game">against the computer</link> or <link 
xref="2player">with another player</link>. Have fun!</p>
 
   <section id="play" style="2column">
     <title>Game Play</title>
   </section>
 
+  <section id="reversi" style="2column">
+    <title>Game of reversi</title>
+  </section>
+
   <section id="tips" style="2column">
     <title>Useful tips</title>
   </section>
diff --git a/help/C/rules.page b/help/C/rules.page
index e033cb5..06b4271 100644
--- a/help/C/rules.page
+++ b/help/C/rules.page
@@ -3,7 +3,7 @@
       type="topic" style="task"
       id="rules">
   <info>
-    <link type="guide" xref="index#play" />
+    <link type="guide" xref="index#reversi" />
     <revision version="0.1" date="2012-03-08" status="final"/>
 
     <credit type="author copyright">
diff --git a/help/C/strategy.page b/help/C/strategy.page
index d338902..439ada3 100644
--- a/help/C/strategy.page
+++ b/help/C/strategy.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="strategy">
   <info>
-    <link type="guide" xref="index#play" />
+    <link type="guide" xref="index#reversi" />
     <revision version="0.1" date="2012-03-08" status="final"/>
 
     <credit type="author copyright">
diff --git a/help/meson.build b/help/meson.build
index e8e63ff..18c258f 100644
--- a/help/meson.build
+++ b/help/meson.build
@@ -11,6 +11,7 @@ help_media = [
     'figures/symmetric-start.png',
     'figures/usual-start.png'
 ]
+
 help_files = [
     '2player.page',
     'ai-game.page',
@@ -32,7 +33,6 @@ help_files = [
     'translate.page'
 ]
 
-
 gnome.yelp(meson.project_name(),
     sources: help_files,
     media: help_media,