Draft versions of these files ... please do not translate yet! :-)

diff --git a/lang/en/help/questions.html b/lang/en/help/questions.html
index d96e3e153672b435fe0cfd05fc1d7a707ee987d1..d868705010af81e974c348a6d3695dcb95ab79f0 100644 (file)
--- a/lang/en/help/questions.html
+++ b/lang/en/help/questions.html
@@ -92,3 +92,6 @@
 \r
 <HR>\r
 <FONT SIZE=1><I>Questions adapted from Paul, R. (1993). Critical Thinking: How To Prepare Students for a Rapidly Changing World: Foundation for Critical Thinking, Santa Rosa, CA. </I></FONT>\r
+\r
+<P ALIGN=RIGHT><? helpbutton("writing", get_string("helpwriting"), "moodle", true, true) ?></P>\r
+<P ALIGN=RIGHT><? helpbutton("reading", get_string("helpreading"), "moodle", true, true) ?></P>\r

diff --git a/lang/en/help/reading.html b/lang/en/help/reading.html
index 03422501b16cf7e49a48c7458dc68cbbde98be1d..4ef817166c3fbd5012199cfdd36db92cd9a016e3 100644 (file)
--- a/lang/en/help/reading.html
+++ b/lang/en/help/reading.html
@@ -1,4 +1,13 @@
 <P ALIGN=CENTER><B>Reading</B></P>\r
 \r
-When reading texts \r
+<P>When reading texts quickly it is often very easy to misunderstand what the \r
+   author was trying to say.</P>\r
 \r
+<P>To avoid misunderstanding, read texts carefully and try to see the words\r
+   from the author's point of view.  Be empathic.</P>\r
+\r
+<P>It can also help to think of what the author has NOT said - this may \r
+   help you form questions in your own mind.</P>\r
+\r
+<P ALIGN=RIGHT><? helpbutton("questions", get_string("helpquestions"), "moodle", true, true) ?></P>\r
+<P ALIGN=RIGHT><? helpbutton("writing", get_string("helpwriting"), "moodle", true, true) ?></P>\r

diff --git a/lang/en/help/writing.html b/lang/en/help/writing.html
index 99627496fd336c0d4844cacf5ba451f2141915ec..85935ac2b02b3b91bc6471cd5a03310b8da89e5c 100644 (file)
--- a/lang/en/help/writing.html
+++ b/lang/en/help/writing.html
@@ -1,4 +1,22 @@
-<P ALIGN=CENTER><B>Writing posts</B></P>\r
+<P ALIGN=CENTER><B>Writing</B></P>\r
 \r
-<P>When writing new posts\r
+(this is a draft help file, please do not translate yet)\r
 \r
+<P>When writing text for others to read, keep your audience in mind.</P>\r
+\r
+<P>Explain your ideas as clearly as you can to help avoid misunderstandings. \r
+   In the forums you can achieve this by keeping your posts short and on-topic, \r
+   instead of one long rambling post that makes many points, it is usually \r
+   better to write several shorter ones (perhaps in separate forums).</P>\r
+\r
+<P>Re-edit your text as much as necessary until you get it right.   \r
+   Even in forum posts you have <?PHP echo ($CFG->maxeditingtime/60) ?> minutes \r
+   after you've posted it to go back and improve it if necessary.</P>\r
+\r
+<P>When replying to others, try and think of interesting questions you \r
+   can ask them.  This will help both you and them think about the \r
+   issue at hand.</P>\r
+\r
+\r
+<P ALIGN=RIGHT><? helpbutton("questions", get_string("helpquestions"), "moodle", true, true) ?></P>\r
+<P ALIGN=RIGHT><? helpbutton("reading", get_string("helpreading"), "moodle", true, true) ?></P>\r