[gbrainy] More work on documentation: introduction, game types, etc

[Jordi Mas <jmas src gnome org>]

commit c9589f9302d4c1669e15c5a9c1d8f4b6b836db55
Author: Jordi Mas <jmas softcatala org>
Date:   Sun Dec 27 17:16:29 2009 +0100

    More work on documentation: introduction, game types, etc

 help/C/figures/history.png |  Bin 0 -> 23258 bytes
 help/C/gametypes.page      |    8 ++++----
 help/C/history.page        |    8 +++++---
 help/C/index.page          |    4 ++--
 help/C/introduction.page   |    9 +++++----
 help/C/playing.page        |    4 +++-
 help/C/results.page        |    2 +-
 help/C/scoring.page        |    6 +++---
 help/Makefile.am           |    3 ++-
 9 files changed, 25 insertions(+), 19 deletions(-)
---
diff --git a/help/C/figures/history.png b/help/C/figures/history.png
new file mode 100644
index 0000000..8d8db1b
Binary files /dev/null and b/help/C/figures/history.png differ
diff --git a/help/C/gametypes.page b/help/C/gametypes.page
index c4a61a9..b84d0f2 100644
--- a/help/C/gametypes.page
+++ b/help/C/gametypes.page
@@ -9,9 +9,9 @@
 
 <p><app>gbrainy</app> provides the following types of games:</p>
 <list>
-	<item><p>Logic puzzles. Games designed to challenge your reasoning and thinking skills.</p></item>
-	<item><p>Mental calculation. Games based on arithmetical operations designed to prove your mental calculation skills.</p></item>
-	<item><p>Memory trainers. Games designed to challenge your short term memory.</p></item>
-	<item><p>Verbal analogies. Games that challenge your verbal aptitude.</p></item>
+	<item><p>Logic puzzles. Games designed to challenge your reasoning and thinking skills. These games are usually based on sequences of elements, visual and spatial skills or relationships between elements.</p></item>
+	<item><p>Mental calculation. Games based on arithmetical operations designed to prove your mental calculation skills. Games based on the use of multiplication, division, addition and subtraction combined in different ways.</p></item>
+	<item><p>Memory trainers. Games designed to challenge your short term memory. These games show to the player a collection of objects and asking to recall them, sometimes establishing relationships between figures, words, numbers or colors.</p></item>
+	<item><p>Verbal analogies. Games that challenge your verbal aptitude. Games that ask you to identify cause and effect, use synonyms or antonyms, or use your vocabulary.</p></item>
 </list>
 </page>
diff --git a/help/C/history.page b/help/C/history.page
index b665ea7..5aafb2a 100644
--- a/help/C/history.page
+++ b/help/C/history.page
@@ -6,8 +6,10 @@
   <link type="guide" xref="index#history"/>
 </info>
 
-<title>Player's history</title>
-
-<p><app>gbrainy</app> saves player game scores to be able to track player's score evolution. Using the preferences the user can select how many games are stored and how many games you have to play in order that gbrainy stores the game. </p>
+<title>Player's Game History</title>
+<p>You can access the <gui>Player's Game History</gui> from the main application menu.</p>
+<media type="image" mime="image/png" src="figures/history.png"></media>
+<p>In this dialog the player can see how his performance has been evolving from every game type during the last recorded game sessions.</p>. 
+<p><app>gbrainy</app> saves the player game scores to be able to track player's score evolution. Using the <link type="topic" xref="preferences">Preferences</link> the user can select how many games sessions are recorded and how many games you have to play in order that the game gets stored. </p>
 
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index 11c7f9d..569768d 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -12,11 +12,11 @@
 	</section>
 
 	<section id="playing" style="1column">
-		<title>A Game Session</title>
+		<title>Game Session</title>
 	</section>
 
 	<section id="history" style="1column">
-		<title>Player's history</title>
+		<title>Player's Game history</title>
 	</section>
 
 	<section id="preferences" style="1column">
diff --git a/help/C/introduction.page b/help/C/introduction.page
index d675541..e89523f 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -6,9 +6,10 @@
   <link type="guide" xref="index#introduction"/>
 </info>
 <title>Introduction</title>
-
 <p><app>gbrainy</app> is a brain teaser game and trainer to have fun and to keep your brain trained. </p>
-<p>It features different game types like logic puzzles, mental calculation games, memory trainers and verbal analogies designed to test different cognitive skills.</p>
-<p><app>gbrainy</app> influences are <link href="http://en.wikipedia.org/wiki/Terry_Stickels";>Terry Stickels</link> works and the <link href="http://en.wikipedia.org/wiki/Dr._Brain";>Dr. Brain</link> classical game.</p>
-<p>There have been recent discussions within the scientific community if brain training software improves cognitive performance. Most of the studies show that there is no or little improvement. However, you can have a good time playing games like gbrainy.</p>
+<p>It features different <link type="topic" xref="gametypes">game types</link> like logic puzzles, mental calculation games, memory trainers and verbal analogies designed to test different cognitive skills. </p>
+<p><app>gbrainy</app> relies heavily on the talent of previous puzzle masters ranging from classic puzzles from the ancient times to the ideas of more recent works like <link href="http://en.wikipedia.org/wiki/Terry_Stickels";>Terry Stickels</link> puzzles or the <link href="http://en.wikipedia.org/wiki/Dr._Brain";>Dr. Brain</link> classical game.</p>
+
+<p>The player choose different difficulty levels making <app>gbrainy</app> enjoyable for kids, adults or senior citizens. It also features player's game history, player's personal records, tips for the player, or fullscreen mode. <app>gbrainy</app> can be also extended easily with new games developed by third parties.</p>
+<p>There have been recent discussions within the scientific community regarding if playing brain training software improves cognitive performance. Most of the studies show that there is no or little improvement. However, you can have a good time playing games like gbrainy.</p>
 </page>
diff --git a/help/C/playing.page b/help/C/playing.page
index 8bc528b..4b94328 100644
--- a/help/C/playing.page
+++ b/help/C/playing.page
@@ -9,8 +9,8 @@
 <section id="starting" style="1column">
 	<title>Starting a game</title>
 	<p>You can start a new game by clicking on the different buttons of the application toolbar.</p>
-	<p>The following buttons are available:</p>
 	<media type="image" mime="image/png" src="figures/toolbar.png"></media>
+	<p>The following buttons are available:</p>	
 	<list>
 		<item><p><gui>All</gui>. Starts a new game playing all the available games.</p></item>
 		<item><p><gui>Logic</gui>. Starts a new game playing all the logic games.</p></item>
@@ -35,5 +35,7 @@
 	<p>Some puzzles include a tip that gives some guidance when trying to solve them. You can use the <gui>Tip</gui> button when it is enabled to get a tip.</p>
 
 	<p>Once you have answered the puzzle you will be informed if you did provide the right answer. You can use the <gui>Next</gui> button to go to the next puzzle.</p>
+	
+	<p>You can pause the game at any moment using the <gui>Pause</gui> button and resume it later at any point.</p>
 </section>
 </page>
diff --git a/help/C/results.page b/help/C/results.page
index 3b5c4b5..0c500e7 100644
--- a/help/C/results.page
+++ b/help/C/results.page
@@ -9,7 +9,7 @@
 <title>Results</title>
 <p>When you finish a game session <app>gbrainy</app> shows a summary of the results of the session.</p>
 <media type="image" mime="image/png" src="figures/results.png"></media>
-
+<p>The results shown here are computed using the <link type="topic" xref="scoring">scoring</link> algorim that takes into account time used, tips and the number of total games.</p>
 <p>If the number of games played in the session are the minimum number defined in the prefences to store the session then the results of the game session are stored in the players' history.</p>
 
 </page>
diff --git a/help/C/scoring.page b/help/C/scoring.page
index ec3ffa3..de9e992 100644
--- a/help/C/scoring.page
+++ b/help/C/scoring.page
@@ -28,7 +28,7 @@
 	<p>With the expected time for the current difficulty level and the time used by the player to complete the game the following logic is applied:</p>
 	<list>
 		<item><p>If the player required less than the time expected scores 100%.</p></item>
-		<item><p>If the player required less than the double of time expected scores 80%.</p></item>
+		<item><p>If the player required more than the time expected scores 80%.</p></item>
 		<item><p>if the player required more than the double of time expected scores 70%.</p></item>
 		<item><p>If the player required more than three times the time expected scores 60%.</p></item>
 	</list>
@@ -37,8 +37,8 @@
 
 <section id="totals" style="1column">
 	<title>Computing the totals</title>
-	<p><app>gbrainy</app> keeps track of the different games types played. To compute the final score of every set of game types it sums all the results of the same game types played and then applies a factor of a logarithm of 10 for the easy difficult level, 20 for the medium difficult level and 30 for master difficult level.</p>
-	<p>This means that to score 100% playing at medium difficult level you need to score 100% on at least 20 games of every game type played, 80 games in you have played all the games times.</p>. 
+	<p><app>gbrainy</app> keeps track of the different games types played. To compute the final score of every set of game types it sums all the results of the same game types played and then applies a factor based on the logarithm of 10 for the easy difficult level, 20 for the medium difficult level and 30 for master difficult level.</p>
+	<p>This means that to score 100% playing at medium difficult level you need to score 100% on at least 20 games of every game type played, 80 games in you have played all the games types.</p>. 	
 	<p>This may sound challenging but allows players to compare game scores from different sessions (in the player history) and allows to better show the progression of the player during all the games that has played.</p>
 </section>
 
diff --git a/help/Makefile.am b/help/Makefile.am
index 301b2b7..a9ce4d7 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -7,7 +7,8 @@ DOC_FIGURES = \
 	figures/toolbar.png	\
 	figures/bottom.png	\
 	figures/results.png	\
-	figures/preferences.png
+	figures/preferences.png	\
+	figures/history.png
 
 DOC_PAGES = \
 	index.page \