[gbrainy] Fixes to documentation



commit 6aa77655788a07b4af08e217af7935cf5eae22d2
Author: Jordi Mas <jmas softcatala org>
Date:   Wed Jan 6 13:06:53 2010 +0100

    Fixes to documentation

 help/C/history.page     |    4 ++--
 help/C/playing.page     |    2 +-
 help/C/preferences.page |   12 ++++++------
 help/C/scoring.page     |    8 ++++----
 4 files changed, 13 insertions(+), 13 deletions(-)
---
diff --git a/help/C/history.page b/help/C/history.page
index 8ed89e1..b851755 100644
--- a/help/C/history.page
+++ b/help/C/history.page
@@ -10,7 +10,7 @@
 <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>By clicking on the <gui>Total</gui>, <gui>Logic</gui>, <gui>Memory</gui>, <gui>Mental Calculation</gui> and <gui>Verbal</gui> checkboxes the user can select which game types results are drawn on the player's game history graphic.</p>
-<p><app>gbrainy</app> saves the player game scores to be able to track player's score evolution. Using the <link 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>
+<p>By clicking on the <gui>Total</gui>, <gui>Logic</gui>, <gui>Memory</gui>, <gui>Mental Calculation</gui> and <gui>Verbal</gui> checkboxes the user can select which game types results are shown on the player's game history graphic.</p>
+<p><app>gbrainy</app> saves the player game scores to be able to track player's score evolution. Using the <link xref="preferences">Preferences</link> the user can select how many games sessions are recorded and how many games you have to play to have the game results stored.</p>
 
 </page>
diff --git a/help/C/playing.page b/help/C/playing.page
index 4049fda..109da7d 100644
--- a/help/C/playing.page
+++ b/help/C/playing.page
@@ -36,6 +36,6 @@
 
 	<p>Once you have answered the game you will be informed if you did provide the right answer. You can use the <gui>Next</gui> button to go to the next game.</p>
 	
-	<p>You can pause the game session using the <gui>Pause</gui> button and resume it later at any point.</p>
+	<p>You can pause the game session using the <gui>Pause</gui> button and resume it at any moment.</p>
 </section>
 </page>
diff --git a/help/C/preferences.page b/help/C/preferences.page
index 22e75ec..53a3cd0 100644
--- a/help/C/preferences.page
+++ b/help/C/preferences.page
@@ -11,15 +11,15 @@
 
 <section id="general" style="1column">
 	<title>General Settings</title>
-	<p>The <gui>Skip games that use colors</gui> option removes, from the list of available games, the games that use colors to challenge the player making it friendly to color blind users.</p>
+	<p>The <gui>Skip games that use colors</gui> option removes, from the list of available games, the games that use colors to challenge the player, making it friendly to color blind users.</p>
 </section>
 
 <section id="difficulty" style="1column">
 	<title>Difficulty Level</title>
-	<p>The difficulty level establishes the complexity of the games shown during a gaming session. It influences the number of elements to remember in memory games, the size of numbers in calculation games, makes more obvious or obfuscated logic puzzles, etc. The available difficulty levels are:</p>
+	<p>The difficulty level establishes the complexity of the games during a gaming session. It influences the number of elements to remember in memory games, the size of numbers in calculation games, makes more obvious or obfuscated logic puzzles, etc. The available difficulty levels are:</p>
 	<list>
-		<item><p><gui>Easy</gui>. The complexity of the games shows is the average for kids.</p></item>
-		<item><p><gui>Medium</gui>. This is the default level of the difficulty of <app>gbrainy</app>. The complexity of the games shown is considered good for a regular player.</p></item>
+		<item><p><gui>Easy</gui>. The complexity of the games is the average for kids.</p></item>
+		<item><p><gui>Medium</gui>. This is the default level of the difficulty of <app>gbrainy</app>. The complexity of the games is considered good for a regular player.</p></item>
 		<item><p><gui>Master</gui>. Ideal for advanced players with a special talent for playing <app>gbrainy</app> alike games.</p></item>
 	</list>
 	<p>The difficulty level additionally fine tunes the scoring algorithm by being more generous when playing at the easy level or more demanding when playing at master level.</p>
@@ -31,7 +31,7 @@
 	<p>These options affect the behaviour of memory games:</p>
 	<list>
 		<item><p><gui>Time in seconds to memorize the challenge</gui>. Establishes the time that a collection of objects is shown to allow the player to memorize it.</p></item>
-		<item><p><gui>Show countdown message</gui>. When checked shows the player a countdown message before every memory game. This is helpfully when playing different game types in a single game session because indicates to the user that should get ready for a memory game. Advanced players usually disable this option.</p></item>
+		<item><p><gui>Show countdown message</gui>. When checked shows the player a countdown message before every memory game. This is helpful when playing different game types in a single game session because indicates to the user that should get ready for a memory game. Advanced players usually disable this option.</p></item>
 	</list>
 </section>
 
@@ -41,7 +41,7 @@
 	<list>
 		<item><p><gui>Minimum number of played games to store the game</gui>. Determines the number of games that a player should play in a game session to store it and make it available in the player's history.</p></item>
 		<item><p><gui>Maximum number of stored games in the player's history</gui>. Once this limit has been reach the result of the older games is removed to store the results of the new game sessions. </p></item>
-		<item><p><gui>Clear Player's Game History</gui>. Clears the player's game history by removing all the previous recorded sessions.</p></item>
+		<item><p><gui>Clear Player's Game History</gui>. Clears the player's game history by removing all the previous recorded game sessions results.</p></item>
 	</list>
 </section>
 
diff --git a/help/C/scoring.page b/help/C/scoring.page
index 297de64..b289011 100644
--- a/help/C/scoring.page
+++ b/help/C/scoring.page
@@ -15,7 +15,7 @@
 
 <section id="games" style="1column">
 	<title>Scoring individual games</title>
-	<p>If the player answers a game incorrectly the player does not get any score for the answer. If the player answers the game correctly <app>gbrainy</app> scores the player considering the time used and if the played used a tip during the game.</p>
+	<p>If the player answers a game incorrectly, the player does not get any score for the answer. If the player answers the game correctly, <app>gbrainy</app> scores the player considering the time used and if the played used a tip during the game.</p>
 
 	<p>When playing at medium difficulty level the player is expected to solve in the time indicated the following game types:</p>
 	<list>
@@ -25,11 +25,11 @@
 		<item><p>Verbal analogies in 30 seconds.</p></item>
 	</list>
 	<p>At easy difficulty level the player is given 30% more time and at master level is given only 70% of the previous times.</p>
-	<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>
+	<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 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 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>
 	<p>Additionally, if the player used the tip then scores only 80% of the previous score for the game.</p>
@@ -39,7 +39,7 @@
 	<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 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 when playing at medium difficult level to get a score of 100% you need to score 100% on at least 20 games of every game type played.</p>
-	<p>This may sound challenging but allows players to compare game scores from different sessions (in the player history) and allows to track better the progression of the player during all the games that has played.</p>
+	<p>This may sound challenging but allows players to compare game scores from different sessions (in the player's game history) and allows to track better the progression of the player during all the games that has played.</p>
 </section>
 
 </page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]