MDL-9890 "Help should be well-formed..." - replacing abused (nested) …

…<blockquote> and <ul> with <div class="indent">, especially in install.html, and other validation errors. Merged.

lang/en_utf8/help/courseformats.html

@@ -1,24 +1,24 @@
 <h1>Moodle course formats</h1>
 
 <h2>Weekly format</h2>
-<ul>
+<p class="indent">
 The course is organised week by week, with a clear start date and a finish date.
 Each week consists of activities.  Some of them, like assignments, may have 
 "open windows" of, say, two weeks after which they become unavailable.
-</ul>
+</p>
 
 <h2>Topics format</h2>
-<ul>
+<p class="indent">
 Very similar to the weekly format, except that each "week" is called a topic.
 A "topic" is not restricted to any time limit.  You don't need to specify any
 dates.
-</ul>
+</p>
 
 <h2>Social format</h2>
-<ul>
+<p class="indent">
 This format is oriented around one main forum, the Social forum, which appears
 listed on the main page.  It is useful for situations that are more freeform.
 They may not even be courses.  For example, it could be used as a departmental
 notice board.
-</ul>
+</p>
 

lang/en_utf8/help/directorypaths.html

@@ -2,12 +2,12 @@ <h1>Directory paths</h1>
 
 <p>The full syntax of a directory path depends on your operating system:</p>
 
-<blockquote>
+<div class="indent">
 
-<p>In <b>Windows Systems</b> use something like:
+<p>In <b>Windows Systems</b> use something like:</p>
 <ul> 
 <li>c:\program files\data\moodle</li>
-<li>c:\documents and settings\moodle\temp\saved</li></p>
+<li>c:\documents and settings\moodle\temp\saved</li>
 </ul>
 
 
@@ -17,8 +17,7 @@ <h1>Directory paths</h1>
 <li>/home/moodle/tmp/saved</li>
 </ul>
 
-
-</blockquote>
+</div>
 
 <p>Note that it's usually a good idea to make sure the directory already exists.  
    Sometimes Moodle can create the directory when required but this is not always possible.</p>

lang/en_utf8/help/enrol/authorize/captureday.html

@@ -1,8 +1,10 @@
-<p align="center"><b>Not only do I want to manually accept/deny payments, but also use autocapture to prevent cancelling payment. What should I do?</b>
+<p class="center">
+  <b>Not only do I want to manually accept/deny payments, but also use autocapture to prevent cancelling payment. What should I do?</b>
+</p>
+
 <ul>
  <li>Setup cron.</li>
  <li>Check an_review.</li>
  <li>Enter a number between 1 and 29 to an_capture_day field.
      Card will be captured and user will be enrolled to course unless you capture it within an_capture_day.</li>
 </ul>
-</p>

lang/en_utf8/help/enrol/authorize/orderreview.html

@@ -1,7 +1,8 @@
-<p align="center"><strong>Use these settings if you want to review orders before processing the credit card.</strong></p>
+<p class="center"><strong>Use these settings if you want to review orders before processing the credit card.</strong></p>
 <p>Uncheck the 'an_review' field if students will be enrolled to courses immediately when they entered their card number.<br />
    If you have checked 'an_review' field, the credit card will be authorized but not be captured and you will have 2 options:
    'Manual-Capture' and 'Scheduled-Capture'.
+</p>
    <ul>
       <li>For Manual-Capture, enter '0' to an_capture_day field. Transaction will be cancelled unless you review it within 30 days.
           Don't panic! Your business is important for us. In 'Email Sending Settings' section, you will be notified X days
@@ -12,5 +13,4 @@
           you may accept or deny the payment after you have received email about new pending order.
           Users can also be mailed for welcome message if you check enrol_mailstudents.</li>
    </ul>
-</p>
-<p align="center"><strong>In Moodle 1.6, you can accept/deny/refund the payments in Payment Managament page.</strong></p>
+<p class="center"><strong>In Moodle 1.6, you can accept/deny/refund the payments in Payment Managament page.</strong></p>

lang/en_utf8/help/enrol/authorize/review.html

@@ -1,12 +1,12 @@
-<p align="center"><b>How will I manually accept/deny payments?</b>
+<p class="center"><b>How will I manually accept/deny payments?</b></p>
+
 <ul>
  <li>Check an_review.</li>
  <li>Enter '0' to an_capture_day field.</li>
 </ul>
-</p>
 
-<p align="center"><b>How will students be enrolled to courses immediately when they entered their card number?</b>
+<p class="center"><b>How will students be enrolled to courses immediately when they entered their card number?</b></p>
+
 <ul>
  <li>Uncheck an_review.</li>
 </ul>
-</p>

lang/en_utf8/help/enrol/imsenterprise/unenrol.html

@@ -6,12 +6,14 @@ <h1>Unenrolling students/teachers</h1>
 
 <ul><li>A &lt;member&gt; element which specifies the given student and course, and with the "recstatus" attribute of the &lt;role&gt; element set to 3 (which means "delete"). THIS IS NOT YET IMPLEMENTED IN THE MOODLE PLUGIN.</li>
 
-<li> A &lt;member&gt; element which specifies the given student and course, and with the &lt;status&gt; element set to 0 (which means "inactive").</li></ul>
-
+<li> A &lt;member&gt; element which specifies the given student and course, and with the &lt;status&gt; element set to 0 (which means "inactive").</li>
+</ul>
 
 <p>The third method is slightly different. It does not require this config setting to be activated, and can be specified well in advance of the unenrolment date:</p>
 
-<ul><li>A <member> element which specifies a <timeframe> for the enrolment can specify the begin and/or end dates for enrolment of this particular student. These dates are loaded into Moodle's enrolment data table if present, and so after the end-date, a student will no longer be able to access that particular course.</li></ul>
+<ul>
+  <li>A &lt;member> element which specifies a &lt;timeframe> for the enrolment can specify the begin and/or end dates for enrolment of this particular student. These dates are loaded into Moodle's enrolment data table if present, and so after the end-date, a student will no longer be able to access that particular course.</li>
+</ul>
 
 
 

lang/en_utf8/help/forum/ratings.html

@@ -1,12 +1,11 @@
-Individual posts can be rated using a scale based on the theory of <strong>separate and connected knowing</strong>.
-
+<h1> Ratings </h1>
 
+<p>Individual posts can be rated using a scale based on the theory of <strong>separate and connected knowing</strong>.
 
 This theory may help you to look at human interactions in a new way. It describes two different ways that we can evaluate and learn about the things we see and hear.
 
-
-
 Although each of us may use these two methods in different amounts at different times, it may be useful to imagine two people as examples, one who is a mostly separate knower (Jim) and the other a mostly connected knower (Mary).
+</p>
 
 <ul>
 
@@ -18,32 +17,29 @@
 
 </ul>
 
-Did you notice in these examples that the separate knower is male and the connected knower is female? Some studies have shown that statistically this tends to be the case, however individual people can be anywhere in the spectrum between these two extremes.
-
-
+<p>Did you notice in these examples that the separate knower is male and the connected knower is female? Some studies have shown that statistically this tends to be the case, however individual people can be anywhere in the spectrum between these two extremes.
 
 For a collaborative and effective group of learners it may be best if everyone were able to use BOTH ways of knowing.
 
-
-
 In a particular situation like an online forum, a single post by a person may exhibit either of these characteristics, or even both. Someone who is generally very connected may post a very separate-sounding message, and vice versa. The purpose of rating each post using this scale is to:
+</p>
 
-<blockquote>
+<ol style="list-style:lower-alpha">
 
-a) help you think about these issues when reading other posts
+  <li> help you think about these issues when reading other posts </li>
 
-b) provide feedback to each author on how they are being seen by others
+  <li> provide feedback to each author on how they are being seen by others </li>
 
-</blockquote>
+</ol>
 
 The results are not used towards student assessment in any way, they are just to help improve communication and learning.
 
 <hr />
-
+<p>
 In case you're interested, here are some references to papers by the authors who originally developed these ideas:
+</p>
 
 <ul>
-
   <li>Belenky, M.F., Clinchy, B.M., Goldberger, N.R., &amp; Tarule, J.M. (1986). 
 
     Women's ways of knowing: the development of self, voice, and mind. New York, 
@@ -78,11 +74,7 @@
 
     as learning styles: Learning MAGIC with a partner. Sex Roles, 44(7/8), 419-436. 
 
-    <br />
-
   </li>
 
 </ul>
 
-
-

lang/en_utf8/help/glossary/displayformat.html

@@ -1,8 +1,8 @@
 <h1>Display format</h1>
 
 <p>This setting specifies the way that each entry will be shown within the glossary.  The default formats are:</p>
-<blockquote>
-<dl>
+
+<dl class="indent">
 <dt><b>Simple Dictionary</b>:</dt>
 <dd>looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.</dd>
 <dt><b>Continuous</b>:</dt>
@@ -16,7 +16,7 @@ <h1>Display format</h1>
 <dt><b>FAQ</b>:</dt>
 <dd>Useful for displaying lists of Frequently Asked Questions.  It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.</dd>
 </dl>
-</blockquote>
+
 
 <hr />
 <p>Moodle Administrators can create new formats following the instructions in

lang/en_utf8/help/glossary/index.html

@@ -1,6 +1,6 @@
 <h2>Glossary</h2>
 
-<ul class="unlist">
+<ul class="un__list">
 <li><h3>Glossary level help files</h3>
 
 <ul>

lang/en_utf8/help/hotpot/responsestable.html

@@ -5,6 +5,7 @@ <h1>Individual Responses</h1>
 </p>
 <p>
     The responses are color-coded as follows:
+</p>
     <ul>
         <li><font color="red"><b>Correct answers</b></font></li>
         <li><font color="brown"><b>Ignored answers</b></font> (if any)</li>
@@ -19,4 +20,3 @@ <h1>Individual Responses</h1>
             </ul>
         </li>
     </ul>
-</p>

lang/en_utf8/help/html.html

@@ -15,6 +15,5 @@ <h1>Help on writing html</h1>
    </ul>
 
 <p>Smilies (emoticons) will be converted into their graphical equivalent, and 
-   bare URLs will be converted into links.</p>
-
+   bare URLs will be converted into links.
 </p>

lang/en_utf8/help/index.html

@@ -28,6 +28,8 @@ <h2>Administration</h2>
   <li><a href="help.php?file=langedit.html">Language editing</a></li>
   <li><a href="help.php?file=uploadgroups.html">Upload groups</a></li>
   <li><a href="help.php?file=uploadusers.html">Upload users</a></li>
+
+  <li><a href="help.php?file=install.html">Installation</a></li>
 </ul>
 
 <h2>Setting up courses</h2>