Permalink
Browse files

Various small fixes and improvements. Nothing too serious.

Not even 1/4 of what I wanted to do today, though.  I had a lot
of other work come in today and I've just run out of steam.  :-(

I'll tackle these docs again another time.
  • Loading branch information...
1 parent 7b0de93 commit d4914c6c842416b979bffabc54036f6161d9645c moodler committed Aug 28, 2003
@@ -60,9 +60,9 @@ <h2>Background</h2>
instructional designers and of course, developers. Like Moodle, this site is
always evolving to suit the needs of the community, and like Moodle it will
always be Free.
-<p>Later in 2003, <a href="http://moodle.com/">moodle.com</a> will be launched
- as a company providing additional commercial support for those need it, as a
- well as a variety of exciting new services.
+<p>In 2003, the company <a href="http://moodle.com/" target="_top">moodle.com</a>
+ was launched to provide additional commercial support for those need it, as
+ well as managed hosting, consulting and other services.
<p>For more about our future plans for Moodle, see the <a href="?file=future.html">Future</a>
roadmap.</p>
View
@@ -111,7 +111,8 @@ <h2 class="normaltext">General Rules</h2>
<ol class="normaltext">
<li>All files should use the .php extension.</li>
- <li>All copyright notices should be retained. You can add your own if necessary.</li>
+ <li>All existing copyright notices must be retained. You can add your own if
+ necessary.</li>
<li>Each file should include the main config.php file.</li>
<li>Each file should check that the user is authenticated correctly, using require_login()
and isadmin(), isteacher(), iscreator() or isstudent().</li>
@@ -132,7 +133,7 @@ <h2 class="normaltext">Coding Style</h2>
<li>Don't use tabs at all. Use consistent indenting with 4 spaces.</li>
<li>Braces must always be used for blocks of code (even if there is only one
line). Moodle uses this style:
- <p class="examplecode"> </font><font color="#006600">if (</font><font color="#0000CC">$quiz</font><font color="#006600">-&gt;</font><font color="#0000CC">attempts</font><font color="#006600">)
+ <p class="examplecode"> <font color="#006600">if (</font><font color="#0000CC">$quiz</font><font color="#006600">-&gt;</font><font color="#0000CC">attempts</font><font color="#006600">)
{<br />
&nbsp;&nbsp;&nbsp;&nbsp;if (</font><font color="#0000CC">$numattempts </font><font color="#006600">&gt;
</font><font color="#0000CC">$quiz</font><font color="#006600">-&gt;</font><font color="#0000CC">attempts</font><font color="#006600">)
View

Large diffs are not rendered by default.

Oops, something went wrong.
@@ -138,9 +138,9 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
for that module. See below.</li>
</ul>
<p>The easiest way to start a new learning activity module is to use the template
- in <strong><a href="http://moodle.com/mod/newmodule_template.zip">mod/newmodule_template.zip</a>.</strong>
+ in <strong><a href="http://moodle.org/mod/newmodule_template.zip">mod/newmodule_template.zip</a>.</strong>
Unzip it and follow the README inside. </p>
- <p>You might also like to post first in the <a href="http://moodle.com/mod/forum/view.php?id=44" target="_top">Activities
+ <p>You might also like to post first in the <a href="http://moodle.org/mod/forum/view.php?id=44" target="_top">Activities
modules forum on Using Moodle</a>.</p>
<p>&nbsp;</p>
</blockquote>
@@ -178,7 +178,7 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
the themes for this will be a completely different format, but the advantage
will be a much higher possible degree of customisation (including moving
elements around the page).</p>
- <p>More discussion about this in the <a target=_top href="http://moodle.com/mod/forum/view.php?id=46">Themes
+ <p>More discussion about this in the <a target=_top href="http://moodle.org/mod/forum/view.php?id=46">Themes
forum on Using Moodle</a>. If you create a nice theme that you think others
might want to use, please post your zip file on the themes forum!<br>
</p>
@@ -229,7 +229,7 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
create new languages but to refine existing ones. If you are starting a
new language, please contact me, <a target=_top href="http://dougiamas.com/">Martin
Dougiamas</a>. </p>
- <p>You might also like to post in the <a target=_top href="http://moodle.com/mod/forum/view.php?id=43">Languages
+ <p>You might also like to post in the <a target=_top href="http://moodle.org/mod/forum/view.php?id=43">Languages
forum on Using Moodle</a>. </p>
<p>If you are maintaining a language an ongoing basis, I can give you <a href="?file=cvs.html">CVS
write access to the Moodle source code</a> so that you can directly maintain
@@ -249,7 +249,7 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
and inside the <strong>db</strong> subdirectory of each module.</p>
<p>Currently, only MySQL and PostgreSQL are fully supported in this way (no-one
wrote the schemas for other brands).</p>
- <p>Moodle 1.1 will use a new method of database-independent XML schemas that
+ <p>Moodle 1.2 will use a new method of database-independent XML schemas that
will make all this unnecessary.</p>
</blockquote>
<p>&nbsp;</p>
@@ -288,10 +288,11 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
<blockquote>
<blockquote>
<blockquote>
- <p align="center">Thanks for using Moodle!</p>
- <p align="center">Cheers,<br>
- <a target=_top href="http://dougiamas.com/">Martin Dougiamas</a></p>
- </blockquote>
+ <p align="center">Thanks for using Moodle!<br>
+ <br>
+ <a target=_top href="http://dougiamas.com/">Martin Dougiamas</a>, Lead
+ Developer </p>
+ </blockquote>
</blockquote>
</blockquote>
<p>&nbsp;</p>
@@ -304,3 +305,4 @@ <h3 class="sectionheading"><a name="contribute" id="contribute"></a>2. How you c
10:34:19 martin Exp $</font></p>
</body>
+</html>
View
@@ -100,11 +100,11 @@ <h2>Frequently Asked Questions (FAQ)</h2>
frequently asked questions by people installing Moodle. If you have
- followed the <a href="http://moodle.org/doc/?file=install.html">installation instructions</a> but
+ followed the <a href="./?file=install.html">installation instructions</a> but
you still have a problem, then this page is probably the best place to be. </p>
-<p class="normaltext">If you don't find your answer here try the <a href="http://moodle.org/mod/forum/index.php?id=5">Using
+<p class="normaltext">If you don't find your answer here try the <a href="http://moodle.org/mod/forum/index.php?id=5" target="_top">Using
Moodle</a> course on moodle.org. Start by searching the forums using a few keywords,
in case your problem has already been discussed. If you don't find
@@ -318,7 +318,7 @@ <h4 class="question"><a name="quotes" id="quotes"></a>Any text I add with an apo
magic_quotes_runtime = Off</p>
-<p class="answer">See the section on <a href="http://moodle.org/doc/?file=install.html#webserver">webserver
+<p class="answer">See the section on <a href="./?file=install.html#webserver">webserver
configuration</a> in the Installation docs for more details.</p>
<p class="answer">&nbsp;</p>
@@ -466,7 +466,7 @@ <h4 class="question"><a name="locale"></a>Why doesn't my Moodle site display the
<p class="answer">You can find the correct locale codes for Windows on these two
pages: <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_language_strings.asp" target="_blank">Language
codes</a> and <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_country_strings.asp" target="_blank">Country/region
- codes</a>.(eg &quot;esp&quot; for spanish)</p>
+ codes</a>.(eg &quot;esp_esp&quot; for spanish)</p>
<p class="answer">These new locale codes can be entered on the Admin -&gt; Configure
-&gt; Variables page, where they override the ones in the currently chosen language
pack.</p>
View
@@ -34,6 +34,8 @@ <h3 class="sectionheading">Overall design</h3>
for initial table definition)</li>
<li>Course listing shows descriptions for every course on the server, including
accessibility to guests.</li>
+ <li>Courses can be categorised and searched - one Moodle site can support thousands
+ of courses</li>
<li>Emphasis on strong security throughout. Forms are all checked, data validated,
cookies encrypted etc</li>
<li>Most text entry areas (resources, forum postings, journal entries etc) can
@@ -47,7 +49,7 @@ <h3 class="sectionheading">Site management</h3>
<li>Plug-in activity modules can be added to existing Moodle installations</li>
<li>Plug-in language packs allow full localisation to any language. These can
be edited using a built-in web-based editor. Currently there are language
- packs for more than <a href="http://moodle.com/download/lang/" target="_top">28
+ packs for over <a href="http://moodle.org/download/lang/" target="_top">34
languages</a>.</li>
<li>The code is clearly-written PHP under a GPL license - easy to modify to
suit your needs</li>
@@ -70,9 +72,14 @@ <h3 class="sectionheading">User management</h3>
can have different access</li>
<li>An admin account controls the creation of courses and creates teachers by
assigning users to courses</li>
+ <li>A course creator account is only allowed to create courses and teach in
+ them</li>
+ <li>Teachers may have editing privileges removed so that they can't modify the
+ course (eg for part-time tutors)</li>
<li>Security - teachers can add an "enrolment key" to their courses to keep
out non-students. They can give out this key face-to-face or via personal
email etc</li>
+ <li>Teachers can enrol students manually if desired</li>
<li>Teachers can unenrol students manually if desired, otherwise they are automatically
unenrolled after a certain period of inactivity (set by the admin)</li>
<li>Students are encouraged to build an online profile including photos, description.
@@ -84,11 +91,12 @@ <h3 class="sectionheading">User management</h3>
</ul>
<h3 class="sectionheading">Course management</h3>
<ul>
- <li>Teacher has full control over all settings for a course</li>
+ <li>A full teacher has full control over all settings for a course, including
+ restricting other teachers</li>
<li>Choice of course formats such as by week, by topic or a discussion-focussed
social format</li>
<li>Flexible array of course activities - Forums, Journals, Quizzes, Resources,
- Choices, Surveys, Assignments.</li>
+ Choices, Surveys, Assignments, Chats, Workshops</li>
<li>Recent changes to the course since the last login can be displayed on the
course home page - helps give sense of community</li>
<li>Most text entry areas (resources, forum postings, journal entries etc) can
@@ -101,6 +109,10 @@ <h3 class="sectionheading">Course management</h3>
journal entries etc on one page.</li>
<li>Mail integration - copies of forum posts, teacher feedback etc can be mailed
in HTML or plain text.</li>
+ <li>Custom scales - teachers can define their own scales to be used for grading
+ forums, assignments and journals</li>
+ <li>Courses can be packaged as a single zip file using the Backup function.
+ These can be restored on any Moodle server.</li>
</ul>
<h3 class="sectionheading">Assignment Module</h3>
<ul>
@@ -116,6 +128,14 @@ <h3 class="sectionheading">Assignment Module</h3>
<li>The teacher can choose to allow resubmission of assignments after grading
(for regrading)</li>
</ul>
+<h3 class="sectionheading">Chat Module</h3>
+<ul>
+ <li>Allows smooth, synchronous text interaction</li>
+ <li>Includes profile pictures in the chat window</li>
+ <li>Supports URLs, smilies, embedded HTML, images etc</li>
+ <li>All sessions are logged for later viewing, and these can also be made available
+ to students</li>
+</ul>
<h3 class="sectionheading">Choice Module</h3>
<ul>
<li>Like a poll. Can either be used to vote on something, or to get feedback
@@ -134,6 +154,8 @@ <h3 class="sectionheading">Forum Module</h3>
<li>The teacher can choose not to allow replies (eg for an announcements-only
forum)</li>
<li>Discussion threads can be easily moved between forums by the teacher</li>
+ <li>Attached images are shown inline</li>
+ <li>If forum ratings are being used, these can be restricted to a range of dates</li>
</ul>
<h3 class="sectionheading">Journal Module</h3>
<ul>
@@ -158,11 +180,17 @@ <h3 class="sectionheading">Quiz Module</h3>
<li>Quiz questions and quiz answers can be shuffled (randomised) to reduce cheating</li>
<li>Questions allow HTML and images</li>
<li>Questions can be imported from external text files</li>
+ <li>Quizzes can be attempted multiple times, if desired</li>
+ <li>Attempts can be cumulative, if desired, and finished over several sessions</li>
<li>Multiple-choice questions supporting single or multiple answers</li>
<li>Short Answer questions (words or phrases)</li>
<li>True-False questions </li>
<li>Matching questions</li>
<li>Random questions</li>
+ <li>Numerical questions (with allowable ranges)</li>
+ <li>Embedded-answer questions (cloze style) with answers within passages of
+ text </li>
+ <li>Embedded descriptive text and graphics</li>
</ul>
<h3 class="sectionheading">Resource Module</h3>
<ul>
@@ -177,6 +205,14 @@ <h3 class="sectionheading">Resource Module</h3>
<h3 class="sectionheading">Survey Module</h3>
<ul><li>Built-in surveys (COLLES, ATTLS) have been proven as instruments for analysing online classes</li><li>Online survey reports always available, including many graphs. Data is downloadable as an Excel spreadsheet or CSV text file.</li><li>Survey interface prevents partly-finished surveys.</li><li>Feedback is provided to the student of their results compared to the class averages</ul>
+<h3 class="sectionheading">Workshop Module</h3>
+<ul>
+ <li>Allows peer assessement of documents, and the teacher can manage and grade
+ the assessment.</li>
+ <li>Supports a wide range of possible grading scales</li>
+ <li>Teacher can provide sample documents for students to practice grading</li>
+ <li>Very flexible with many options.</li>
+</ul>
<p>&nbsp;</p>
<p align="CENTER"><font size="1"><a href="." target="_top">Moodle Documentation</a></font></p>
@@ -57,10 +57,10 @@ <h3 class="sectionheading"><a name="requirements"></a>1. Requirements</h3>
caused by Safe Mode)</li>
</ul>
</li>
- <li>a working database server: <a href="http://www.mysql.com/" target="_blank">MySQL</a> or
- <a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a> are completely supported
- and recommended for use with Moodle 1.0.9. All other databases will be supported
- fully in Moodle 1.1.</li>
+ <li>a working database server: <a href="http://www.mysql.com/" target="_blank">MySQL</a>
+ or <a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a> are
+ completely supported and recommended for use with Moodle 1.1. All other
+ databases will be supported fully in the next release.</li>
</ol>
<p>Most web hosts support all of this by default. If you are signed up with
one of the few webhosts that does not support these features ask them why,
@@ -23,33 +23,51 @@ <h2>Installing Apache, MySQL and PHP</h2>
you must have a working PHP installation and a working database to turn your
computer into a functional web server platform. These packages can be tricky
to set up for average computer users, so this page has been written to try to
- make this process as simple as possible for different platforms.</p>
-<p>&nbsp;</p>
-<h3 class="sectionheading">Mac OS X</h3>
+ make this process as simple as possible for different platforms:</p>
+<ul>
+ <li><a href="#host" class="questionlink">Hosting Service</a></li>
+ <li><a href="#mac" class="questionlink">Mac OS X</a></li>
+ <li><a href="#redhat" class="questionlink">Redhat Linux</a></li>
+ <li><a href="#windows" class="questionlink">Windows</a></li>
+</ul>
+<p class="questionlink">&nbsp;</p>
+<h3 class="sectionheading"><a name="host" id="host"></a>Hosting Service</h3>
+<blockquote>
+ <p>Unfortunately hosting services vary quite a lot in the way they work. Some
+ will even install Moodle for you.</p>
+ <p>Most will offer a web-based control panel to control your site, create databases
+ and set up cron. Some may also offer terminal access via ssh, so that you
+ can use the command shell to do things.</p>
+ <p>You should work your way through the <a href="./?file=install.html">Installation
+ guide</a> and take each step at a time. Ask your hosting provider if you get
+ stuck. </p>
+ <p>&nbsp;</p>
+</blockquote>
+<h3 class="sectionheading"><a name="mac" id="mac"></a>Mac OS X</h3>
<blockquote>
<p>The easiest way to do this is use the Apache server that Apple provides,
and add PHP and MySQL using Marc Liyanage's packages. Both of the pages below
come with good instructions that we won't duplicate here:</p>
- <blockquote>
+ <blockquote>
<p><strong>PHP</strong>: Download from here: <a href="http://www.entropy.ch/software/macosx/php/" target="_top">http://www.entropy.ch/software/macosx/php/</a></p>
<p><strong>MySQL</strong>: Download here: <a href="http://www.entropy.ch/software/macosx/mysql/" target="_top">http://www.entropy.ch/software/macosx/mysql/</a></p>
</blockquote>
<p>Once these are installed the standard <a href="./?file=install.html">Installation
guide</a> should be fairly straightforward.</p>
- <p>More details might be added here later ...</p>
+ <p>A more detailed walkthrough is here: <a href="http://moodle.org/wiki/index.php/InstallingMoodle">http://moodle.org/wiki/index.php/InstallingMoodle</a></p>
<p>&nbsp;</p>
</blockquote>
-<h3 class="sectionheading">Redhat Linux</h3>
+<h3 class="sectionheading"><a name="redhat"></a>Redhat Linux</h3>
<blockquote>
<p>You should install all available RPM packages for Apache, PHP and MySQL.
One package that people frequently forget is the php-mysql package which is
necessary for PHP to talk to MySQL.</p>
<p>Once these are installed the standard <a href="./?file=install.html">Installation
guide</a> should be fairly straightforward.</p>
- <p>More details might be added here later ...</p>
+ <p>A more detailed walkthrough is here: <a href="http://moodle.org/wiki/index.php/InstallingMoodle">http://moodle.org/wiki/index.php/InstallingMoodle</a></p>
</blockquote>
<p>&nbsp;</p>
-<h3 class="sectionheading">Windows</h3>
+<h3 class="sectionheading"><a name="windows" id="windows"></a>Windows</h3>
<blockquote>
<p>The easiest way to do this is use <a href="http://www.easyphp.org/" target="_blank">EasyPHP</a>,
a package that bundles all the software you need into a single Windows application.
@@ -127,7 +145,7 @@ <h3 class="sectionheading">Windows</h3>
your PHP is set up correctly and avoid common problems:</p>
<ul>
<li>Make sure you enable the GD module so Moodle can process images - you
- may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd.dll'.
+ may have to edit php.ini and remove the comment (;) from this line: 'extension=php_gd2.dll'.
</li>
<li>Make sure sessions is turned on - you may have to edit php.ini and fix
the directory for <strong>session.save_path</strong> - instead of the default
@@ -139,3 +157,4 @@ <h3>&nbsp;</h3>
<p align="CENTER"><font size="1">Version: $Id$</font></p>
</body>
+</html>
Oops, something went wrong.

0 comments on commit d4914c6

Please sign in to comment.