]> git.mjollnir.org Git - moodle.git/commitdiff
Some tweaks
authormoodler <moodler>
Thu, 29 May 2003 14:41:14 +0000 (14:41 +0000)
committermoodler <moodler>
Thu, 29 May 2003 14:41:14 +0000 (14:41 +0000)
lang/en/docs/cvs.html
lang/en/docs/teacher.html

index 03f7134ead748f8bc12deccff199988a2dda92b0..1c6aca1fa12c6be00e8e767d0f0bab6f6aca8648 100644 (file)
@@ -3,6 +3,18 @@
 <title>Moodle Docs: How to use CVS</title>\r
     <link rel="stylesheet" href="../theme/standard/styles.php" type="TEXT/CSS">\r
     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
+               <style type="text/css">\r
+    <!--\r
+    .sectionheading {\r
+         font-size: medium;\r
+         font-weight: bold;\r
+         font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;\r
+         border: 1px dotted;\r
+         padding: 10px;\r
+         background-color: #EEEEEE;\r
+    }\r
+    -->\r
+    </style>\r
 </head>\r
 <body bgcolor="#ffffff">\r
 <h2>Using CVS to access and update Moodle source code</h2>\r
@@ -29,7 +41,7 @@
   <p>With that done, you should have all the permissions you need, so you just \r
     need to set up your machine and download the current sources so you can start \r
     working on them. Below are instructions for Unix and Windows systems.</p>\r
-  <h3>1. Using CVS on Unix</h3>\r
+  <h3 class="sectionheading">1. Using CVS on Unix</h3>\r
   <blockquote> \r
     <p>Sourceforge CVS uses ssh as a transport layer for security, so you will \r
       have to set this CVS_RSH environment variable in your Unix shell:</p>\r
@@ -81,7 +93,7 @@ update -dP</strong> </pre>
     <p>Try 'cvs help' for more details ... </p>\r
     <p>&nbsp;</p>\r
   </blockquote>\r
-  <h3>2. Using CVS on Windows</h3>\r
+  <h3 class="sectionheading">2. Using CVS on Windows</h3>\r
   <blockquote> \r
     <p>First, you need to download a completely fresh copy of Moodle using your \r
       developer account.</p>\r
index a219dcfc240b28004248fb70e01529349a5d0098..8659b7a5fd32da61cb46cd123a919141d137827f 100644 (file)
@@ -10,7 +10,6 @@
          font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;\r
          border: 1px dotted;\r
          padding: 10px;\r
-         background-color: #EEEEEE;\r
     }\r
     -->\r
     </style>\r
@@ -19,9 +18,9 @@
 <body bgcolor="#FFFFFF">\r
 \r
 <h2>Teacher Manual</h2>\r
-<p>This page is a quick guide to creating online courses with Moodle. It outlines \r
-  the main functions that are available, as well as some of the main decisions \r
-  you'll need to make.</p>\r
+<p>This page is a very quick guide to creating online courses with Moodle. It \r
+  outlines the main functions that are available, as well as some of the main \r
+  decisions you'll need to make.</p>\r
 \r
 <p>Sections in this document:</p>\r
 <ol>\r
           lets you edit whatever it is next to.</p>\r
         <p><img src="../pix/help.gif" width="22" height="17"> - the <strong>help \r
           icon</strong> will provide you with a popup help window </p>\r
+        <p>&nbsp;<img src="../pix/i/hide.gif" width="16" height="16"> - the <strong>open-eye \r
+          icon</strong> will let you hide something from students</p>\r
+        <p>&nbsp;<img src="../pix/i/show.gif" width="16" height="16"> - the <strong>closed-eye \r
+          icon</strong> will make a hidden item available</p>\r
       </blockquote>\r
     </li>\r
     <li><strong>Use the navigation bar at the top of each page</strong>\r
@@ -56,8 +59,8 @@
       should help remind you where you are and prevent getting lost.\r
     </blockquote></li>\r
   </ol>\r
-  <hr>\r
-</blockquote>\r
+  \r
+<p>&nbsp;</p></blockquote>\r
 <h3 class="sectionheading"><a name="settings"></a>Course settings</h3>\r
 <blockquote> \r
   <p>The first thing you should do is look under the &quot;Administration&quot; \r
@@ -91,8 +94,8 @@
     format doesn't use much content at all and is based around just one forum \r
     - this is displayed on the main page.</p>\r
   <p>See the help buttons on the Course Settings page for more details.</p>\r
-  <hr>\r
-</blockquote>\r
+  \r
+<p>&nbsp;</p></blockquote>\r
 <h3 class="sectionheading"><a name="upload"></a>Uploading files</h3>\r
 <blockquote> \r
   <p>You may have existing content that you want to add to your course, such as \r
   <p>A final note: if your content resides out on the web then you don't need \r
     to upload the files at all - you can link directly to them from inside the \r
     course (see the Resources module and the next section).</p>\r
-  <hr>\r
-</blockquote>\r
+  \r
+<p>&nbsp;</p></blockquote>\r
 <h3 class="sectionheading"><a name="activities"></a>Setting up activities</h3>\r
 <blockquote> \r
   <p>Building a course involves adding course activity modules to the main page \r
       date they upload their file is recorded. Afterwards, you will have a single \r
       page on which ou can view each file (and how late or early it is), and then \r
       record a grade and a comment. Half an hour after you grade any particular \r
-      student, Moodle will automatically email that student a notification. </dd><br>\r
+      student, Moodle will automatically email that student a notification. </dd>\r
+    <br>\r
     <br>\r
     <dt><strong>Choice</strong></dt>\r
     <dd>A choice activity is very simple - you ask a question and specify a choice \r
-      of responses. Students can make their choice, and you \r
-      have a report screen where you can see the results. I use it to gather research \r
-      consent from my students, but you could use it for quick polls or class \r
-      votes.</dd>\r
+      of responses. Students can make their choice, and you have a report screen \r
+      where you can see the results. I use it to gather research consent from \r
+      my students, but you could use it for quick polls or class votes.</dd>\r
     <br>\r
     <br>\r
     <dt><strong>Forum</strong></dt>\r
     <dd>Each journal activity is an entry in the whole course journal. For each \r
       one you can specify an open-ended question that guides what students write, \r
       as well as a window of time in which the journal is open (weekly course \r
-      format only). Encourage students to write reflectively and critically in \r
-      these journals, as they are only available to them and you. Afterwards, \r
-      you will be able to grade and comment all the entries for that week or topic, \r
-      and students will receive an automatic email informing them of your feedback.</dd>\r
+      format only). A general rule of thumb is to create one journal per week. \r
+      Encourage students to write reflectively and critically in these journals, \r
+      as they are only available to them and you. Afterwards, you will be able \r
+      to grade and comment all the entries for that week or topic, and students \r
+      will receive an automatic email informing them of your feedback. Journals \r
+      are not designed to be continually added to - if you need to do that then \r
+      add more journal activities.</dd>\r
     <br>\r
     <br>\r
     <dt><strong>Resource</strong></dt>\r
     <dd>Resources are the content of your course. Each resource can be any file \r
-      you have uploaded or can point to using a URL. You can also maintain simple text-based pages by typing them\r
-         directly into a form.</dd>\r
+      you have uploaded or can point to using a URL. You can also maintain simple \r
+      text-based pages by typing them directly into a form.</dd>\r
     <br>\r
     <br>\r
     <dt><strong>Quiz</strong></dt>\r
-    <dd>This module allows you to design and set quiz tests, consisting of\r
-       multiple choice, true-false, and short answer questions.  These\r
-       questions are kept in a categorised database, and can be re-used\r
-       within courses and even between courses.  Quizzes can allow\r
-       multiple attempts.  Each attempt is automatically marked, and the\r
-       teacher can choose whether to give feedback or to show correct answers.\r
-       This module includes grading facilities.\r
-    </dd>\r
+    <dd>This module allows you to design and set quiz tests, consisting of multiple \r
+      choice, true-false, and short answer questions. These questions are kept \r
+      in a categorised database, and can be re-used within courses and even between \r
+      courses. Quizzes can allow multiple attempts. Each attempt is automatically \r
+      marked, and the teacher can choose whether to give feedback or to show correct \r
+      answers. This module includes grading facilities. </dd>\r
     <br>\r
     <br>\r
     <dt><strong>Survey</strong></dt>\r
-    <dd>The survey module provides a number of predefined survey instruments that are useful in \r
-         evaluating and understanding your class.  Currently they include the COLLES and the ATTLS instruments.\r
-         They can be given to students early in the course as a diagnostic tool and at the end of the \r
-         course as an evaluation tool (I use one every week in my courses).</dd>\r
+    <dd>The survey module provides a number of predefined survey instruments that \r
+      are useful in evaluating and understanding your class. Currently they include \r
+      the COLLES and the ATTLS instruments. They can be given to students early \r
+      in the course as a diagnostic tool and at the end of the course as an evaluation \r
+      tool (I use one every week in my courses).</dd>\r
   </dl>\r
   <br>\r
   <p>After adding your activities you can move them up and down in your course \r
     <img src="../pix/t/down.gif" width="9" height="10">) next to each one. You \r
     can also delete them using the cross icon <img src="../pix/t/delete.gif" width="10" height="10">, \r
     and re-edit them using the edit icon <img src="../pix/t/edit.gif" width="10" height="11">.</p>\r
-  <hr>\r
-</blockquote>\r
+  \r
+<p>&nbsp;</p></blockquote>\r
 <h3 class="sectionheading"><a name="course"></a>Running the course</h3>\r
 <blockquote> \r
-  <p>I could write a thesis about this. Actually I <strong>am</strong> writing \r
-    a thesis about this. <img src="../pix/s/biggrin.gif" width="15" height="15"></p>\r
-  <p>Until then here are just a few quick pointers:</p>\r
+  <p>There are some big plans to extend this document into a more comprehensive \r
+    tutorial. Until then here are a few ideas:</p>\r
   <ol>\r
-    <li>Subscribe yourself to all the forums.</li>\r
+    <li>Subscribe yourself to all the forums so you keep in touch with your class \r
+      activity. </li>\r
     <li>Encourage all the students fill out their user profile (including photos) \r
-      and read them all - this will help provide some context to their later writings.</li>\r
+      and read them all - this will help provide some context to their later writings \r
+      and help you to respond in ways that are tailored to their own needs.</li>\r
     <li>Keep notes to yourself in the private &quot;<strong>Teacher's Forum</strong>&quot; \r
       (under Administration). This is especially useful when team teaching.</li>\r
     <li>Use the &quot;<strong>Logs</strong>&quot; link (under Administration) \r
       but it's a crucial part of building and maintaining a community feel in \r
       your course.</li>\r
   </ol>\r
-  <hr>\r
-</blockquote>\r
+  \r
+<p>&nbsp;</p></blockquote>\r
 <h3 class="sectionheading"><a name="further"></a>Further information</h3>\r
 <blockquote> \r
   <p>If you have any particular problems with your site, you should contact your \r
     local site administrator.</p>\r
   <p>If you have some great ideas for improvements to Moodle, or even some good \r
-    stories, come over to <a href="http://moodle.org/" target="_top">moodle.org</a> and join \r
-    in the course called "<a href="http://moodle.org/course/view.php?id=5" target=_top >Using Moodle</a>". \r
-    We'd love to hear from you, and you can help Moodle improve.</p>\r
+    stories, come over to <a href="http://moodle.org/" target="_top">moodle.org</a> \r
+    and join us in the course called "<a href="http://moodle.org/course/view.php?id=5" target=_top >Using \r
+    Moodle</a>". We'd love to hear from you, and you can help Moodle improve.</p>\r
   <p>If you want to contribute to coding new modules, or writing documentation, \r
     or papers, contact me: <a href="http://dougiamas.com/" target="_top">Martin \r
     Dougiamas</a> or browse the &quot;bug tracker&quot; site for Moodle, at <a href="http://moodle.org/bugs/" target="_top">moodle.org/bugs</a></p>\r
-  <p align="center">Thanks for using Moodle - good luck!</p>\r
+  <p align="center">Thanks for using Moodle - and good luck with your teaching!</p>\r
   <hr>\r
   <p>&nbsp;</p>\r
 </blockquote>\r