<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://docs.moodle.org/dev/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Utcursch</id>
	<title>MoodleDocs - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://docs.moodle.org/dev/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Utcursch"/>
	<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/Special:Contributions/Utcursch"/>
	<updated>2026-07-15T01:01:51Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.5</generator>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Utkarshraj_Atmaram&amp;diff=23665</id>
		<title>User talk:Utkarshraj Atmaram</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Utkarshraj_Atmaram&amp;diff=23665"/>
		<updated>2007-12-19T09:00:44Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: m&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;Please sign your messages. You can sign using four tildes: &amp;lt;nowiki&amp;gt;~~~~&amp;lt;/nowiki&amp;gt;&#039;&#039;&#039;.&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19458</id>
		<title>User:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19458"/>
		<updated>2007-12-19T09:00:07Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: wrong page&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;#REDIRECT[[User:Utkarshraj Atmaram]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22929</id>
		<title>User talk:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22929"/>
		<updated>2007-12-19T08:59:50Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: wrong page&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;#REDIRECT[[User talk:Utkarshraj Atmaram]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19457</id>
		<title>User:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19457"/>
		<updated>2007-12-19T08:39:41Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: m&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[http://en.wikipedia.org/wiki/User:Utcursch Utkarshraj Atmaram]. I managed [http://moodle.dbit.in moodle.dbit.in] during college days.&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=Activity_modules&amp;diff=705</id>
		<title>Activity modules</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=Activity_modules&amp;diff=705"/>
		<updated>2006-04-18T07:02:19Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: +cat&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;Activity modules&#039;&#039;&#039; reside in the &#039;mod&#039; directory. Each module is in a separate subdirectory and consists of the following mandatory elements (plus extra scripts unique to each module):&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;mod.html&#039;&#039; - a form to set up or update an instance of this module&lt;br /&gt;
* &#039;&#039;version.php&#039;&#039; - defines some meta-info and provides upgrading code&lt;br /&gt;
* &#039;&#039;icon.gif&#039;&#039; - a 16x16 icon for the module&lt;br /&gt;
* &#039;&#039;db/&#039;&#039; - SQL dumps of all the required db tables and data (for each database type)&lt;br /&gt;
* &#039;&#039;index.php&#039;&#039; - a page to list all instances in a course&lt;br /&gt;
* &#039;&#039;view.php&#039;&#039; - a page to view a particular instance&lt;br /&gt;
* &#039;&#039;lib.php&#039;&#039; - any/all functions defined by the module should be in here. If the modulename is called widget, then the required functions include:&lt;br /&gt;
:* widget_add_instance() - code to add a new instance of widget&lt;br /&gt;
:* widget_update_instance() - code to update an existing instance&lt;br /&gt;
:* widget_delete_instance() - code to delete an instance&lt;br /&gt;
:* widget_user_outline() - given an instance, return a summary of a user&#039;s contribution&lt;br /&gt;
:* widget_user_complete() - given an instance, print details of a user&#039;s contribution&lt;br /&gt;
:* Other functions available but not required are:&lt;br /&gt;
:** widget_delete_course() - code to clean up anything that would be leftover after all instances are deleted&lt;br /&gt;
:** widget_process_options() - code to pre-process the form data from module settings&lt;br /&gt;
:* To avoid possible conflict, any module functions should be named starting with widget_ and any constants you define should start with WIDGET_&lt;br /&gt;
* &#039;&#039;config.html&#039;&#039; - (optional) a form to set up or update global settings of this module&lt;br /&gt;
* Lastly, each module will have some language files that contain strings for that module.&lt;br /&gt;
&lt;br /&gt;
IMPORTANT: When creating a new module, the new name of the module must not contain numbers or other special characters! &lt;br /&gt;
&lt;br /&gt;
==See also==&lt;br /&gt;
&lt;br /&gt;
* http://download.moodle.org/download.php/modules/NEWMODULE.zip - new module template for starting module development. Please follow the README instructions inside the zip.&lt;br /&gt;
* Using Moodle [http://moodle.org/course/view.php?id=5 Activity modules] forum&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Category:Module]]&lt;br /&gt;
&lt;br /&gt;
[[es:Módulos de actividades (desarrollador)]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=Question_engine&amp;diff=3311</id>
		<title>Question engine</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=Question_engine&amp;diff=3311"/>
		<updated>2006-04-18T06:57:37Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: +cat&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Moodle has a powerful question engine with a modular structure to allow question type plug-ins. The question engine is responsible for rendering the questions and for processing student responses. It is used by the [[Quiz developer docs|quiz module]] and it is planned that in future it will be used by the Lesson and other modules.&lt;br /&gt;
&lt;br /&gt;
Historically the question engine started as a part of the quiz module. Only since Moodle 1.6 is it a separate core component of Moodle that can be used by any other Moodle component or module. During this restructuring the code was moved from mod/quiz/ to question/ and the tables and functions were renamed. Wherever the old table or function name contained &#039;quiz_&#039; the new one will contain &#039;question_&#039;&lt;br /&gt;
&lt;br /&gt;
==Terminology==&lt;br /&gt;
&lt;br /&gt;
When talking about the question engine there are certain terms that can cause confusion because they can be used with different meanings. In Moodle we have adopted a certain terminology that will be explained below.&lt;br /&gt;
&lt;br /&gt;
===Questions===&lt;br /&gt;
&lt;br /&gt;
A &#039;&#039;&#039;question&#039;&#039;&#039; is the set of definitions (question name, question text, possible answers, grading rules, feedback, etc.) that constitute a reusable assessment item. So it includes much more than what one would in everyday language understand under a question.&lt;br /&gt;
In the terminology of the QTI specification a &#039;question&#039; is more appropriately called an &#039;&#039;&#039;assessment item&#039;&#039;&#039; or just &#039;item&#039; for short. &lt;br /&gt;
&lt;br /&gt;
There are different types of questions, like for example multiple-choice questions or numerical questions. These are referred to as &#039;&#039;&#039;[[Question engine#Question types|question types]]&#039;&#039;&#039; in Moodle.&lt;br /&gt;
&lt;br /&gt;
Since version 1.5 Moodle is able to handle so-called &#039;&#039;&#039;[[Adaptive questions]]&#039;&#039;&#039;, also known as &#039;adaptive items&#039; in QTI speak. These are questions that walk the user through a directed graph of question states depending on the user&#039;s responses. For example a complicated mathematical question that is answered incorrectly, but is likely to be incorrect because of a common mistake, could provide the user with a hint towards this mistake, apply a penalty and allow a second attempt at this question. Quizzes can be run in &#039;adaptive mode&#039;, in which case Moodle provides buttons to mark each question individually.&lt;br /&gt;
&lt;br /&gt;
===Answers===&lt;br /&gt;
&lt;br /&gt;
In Moodle the term &#039;&#039;&#039;&#039;answer&#039;&#039;&#039;&#039; is used exclusively for the &#039;&#039;&#039;teacher-defined answers&#039;&#039;&#039; of a question. When talking about the quiz module it is easy to get confused between these teacher-defined answers and the answers that the students actually give. We have therefore adopted the convention to refer to the student-supplied answers as &#039;responses&#039; and to reserve the term &#039;answers&#039; to apply to teacher-defined answers. In question types that rely on teacher-supplied answers these are used in the grading process by comparing them with the student responses. Of course not all question types use teacher-defined answers but use some more intelligent way to process the student responses. &lt;br /&gt;
&lt;br /&gt;
Perhaps one should also stress that &#039;answer&#039; is not always used in the sense of &#039;correct answer&#039;. For example every choice in a multiple-choice question is referred to as an answer. Other systems use the term &#039;distractor&#039; for wrong answers. &lt;br /&gt;
&lt;br /&gt;
In Moodle we always use the term &#039;&#039;&#039;&#039;responses&#039;&#039;&#039;&#039; to refer to the students&#039; responses to a question because the term &#039;answers&#039; that one might also be tempted to use for this is already used to refer to the teacher-defined answers, see above. This term is always used in plural, although for some questiontypes there is only one possible response.&lt;br /&gt;
&lt;br /&gt;
There is unfortunately, for historical reasons, one exception to the above rule: The [[Question database structure#quiz_states|quiz_states table]] has a field &#039;answer&#039; whose purpose it actually is to hold the student&#039;s responses.&lt;br /&gt;
&lt;br /&gt;
===Attempts===&lt;br /&gt;
&lt;br /&gt;
In Moodle the term &#039;&#039;&#039;&#039;attempt&#039;&#039;&#039;&#039; is used in the sense of &amp;quot;Attempt at a quiz&amp;quot; (or another activity involving questions). Depending on the quiz settings, a student may be allowed several attempts at a quiz. An attempt is finished when the student clicks on the corresponding button on the attempt page. Students do not have to complete an attempt in one visit. They can navigate away from the quiz page and return later to continue the same attempt.&lt;br /&gt;
&lt;br /&gt;
Within one and the same quiz attempt a student may make several attempts at answering a particular question, at least if the questiontype allows it and the quiz is set up in adaptive mode. These will always be referred to as &#039;&#039;&#039;&#039;attempts at a question&#039;&#039;&#039;&#039;, never just as &#039;attempts&#039;.&lt;br /&gt;
&lt;br /&gt;
Because a student can have several attempts at a question within the same attempt at the quiz, there is a lot of data that needs to be stored as the student takes the question through several &#039;&#039;&#039;&#039;states&#039;&#039;&#039;&#039; by repeated interactions with the question. A state object holds the most recent state of the question and whenever a student submits a response or a similar &#039;&#039;&#039;&#039;event&#039;&#039;&#039;&#039; occurs, the question goes to a new state. The complete history of question states that the question is taken through is saved and this is referred to as the question &#039;&#039;&#039;&#039;session&#039;&#039;&#039;&#039;. Usually only the most recent state and the last graded state are of interest though.&lt;br /&gt;
&lt;br /&gt;
===Sessions, States, Events===&lt;br /&gt;
&lt;br /&gt;
When a new attempt is started, a new &#039;&#039;&#039;session&#039;&#039;&#039; is started for each question. So in a sense a session is for a question what an attempt is for a whole quiz. A question session lasts no longer than an attempt and for each question there can only by one session within one attempt.&lt;br /&gt;
&lt;br /&gt;
Moodle allows the student to interact with a question repeatedly within one session and each such interaction leads to a new &#039;&#039;&#039;state&#039;&#039;&#039;. The first state is created when the session is created. A new state is then created when a student saves and answer or validates an answer or submits an answer or .... The student&#039;s responses and, if appropriate, the results of response processing (grading) are stored in the new state that gets created.&lt;br /&gt;
&lt;br /&gt;
The type of &#039;&#039;&#039;event&#039;&#039;&#039; that led to the creation of a particular state is saved along with the state. The types of events currently used are:&lt;br /&gt;
;open :A new session has just been created and this is the opening state. Usually it doesn&#039;t hold student responses yet (except where a quiz attempt is based on a previous attempt because the &#039;attemptonlast&#039; option is set).&lt;br /&gt;
;save:The student has clicked the save button.&lt;br /&gt;
;validate:The student has asked for his responses to be validated. This means it is checked that they are valid responses. In the case of mathematical questions which requires the input of a mathematical expression in some linear format the question type may want to display the validated result back to the student in typeset form. Similar things may apply to other subject-specific question types. If a student response is found to be invalid the student is told so but no penalty is applied. The invalid response is stored with the state.&lt;br /&gt;
;grade:The student has pressed the submit button. The grade is calculated and stored with the attempt.&lt;br /&gt;
;duplicategrade:The student has pressed the submit button but the response to this question has not actually changed. This happens a lot in quizzes with several questions on on page where the student may have changed the responses for one question only. I believe that states created by this type of event are not stored in the database.&lt;br /&gt;
;close:The last state in a session which is now closed. Currently a session closes only when the attempt closes, either because the student requests it or because the timelimit elapses.&lt;br /&gt;
&lt;br /&gt;
There are now plans to introduce another event type&lt;br /&gt;
;submit:The student has submitted his responses for grading but grading has not yet taken place. This will be used by teacher-marked question types like the essay questions for example.&lt;br /&gt;
&lt;br /&gt;
==Code documentation==&lt;br /&gt;
&lt;br /&gt;
The code is documented according to phpdoc conventions. The explanations here in the wiki are meant to complement this.&lt;br /&gt;
&lt;br /&gt;
Inline comments should be used liberally in the code. The following conventions make it easier to search for comments with special meaning:&lt;br /&gt;
* use TODO in comments about things that need to be done&lt;br /&gt;
* use ??? in comments that are questions about the code&lt;br /&gt;
&lt;br /&gt;
==API==&lt;br /&gt;
&lt;br /&gt;
The library lib/questionlib.php contains all functions that need to be available to any module wanting to use questions (this is new in Moodle 1.6, in Moodle 1.5 this was part of mod/quiz/locallib.php). Loading this library instantiates all questiontype classes by loading the questiontype.php files&lt;br /&gt;
&lt;br /&gt;
A description of the API still needs to be written. Also lib/questionlib.php should be cleaned up a bit to distinguish between the API functions and the helper functions.&lt;br /&gt;
&lt;br /&gt;
==Organisation==&lt;br /&gt;
The default questiontype class is defined in &#039;&#039;&#039;question/type/questiontype.php&#039;&#039;&#039; (in Moodle 1.5 this was still in mod/quiz/locallib.php). The individual questiontypes extend this class in their own questiontype.php file. For documentation of the questiontype classes one should often look at the documentation of the default question type because much of the documentation that is in the default class is not repeated in the other questiontype classes.&lt;br /&gt;
&lt;br /&gt;
While questiontypes are realized as classes, the question engine is not written in a truly object-oriented way. Instead it follows the Moodle model of using objects mostly only as alternatives to arrays to hold database records. So none of the question, attempt, and state objects that play a central role in the module have any methods. Only the questiontype objects have methods. Strangely enough the quiz module instantiates one object of each questiontype class at the start and then reuses their methods for the different questions. If one is used to the Moodle way of programming then this is easy enough to handle.&lt;br /&gt;
&lt;br /&gt;
==Objects and data structures==&lt;br /&gt;
&lt;br /&gt;
Key to understanding how the quiz module works is to understand the different kinds of object work together. The most important ones are:&lt;br /&gt;
&lt;br /&gt;
*Quizzes&lt;br /&gt;
*Questions&lt;br /&gt;
*Attempts&lt;br /&gt;
*States&lt;br /&gt;
&lt;br /&gt;
Quizzes and Questions are data created by the teacher when setting up and editing a quiz. Attempts and States are data created by the student when interacting with a quiz. &lt;br /&gt;
&lt;br /&gt;
Moodle allows students to make several attempts at a quiz. Data about such an attempt is stored in an attempt object. This holds for example how the quiz was randomized for this attempt and the ordering of the questions and answers. So attempts are indexed by user id and quiz id.&lt;br /&gt;
&lt;br /&gt;
Moodle allows students to interact repeatedly with a single question. So for example the student might initially just save an answer, later mark it, then correct it if it was marked incorrect. Each time the student interacts with a particular question inside a particular attempt at a quiz a new state is created. So states are indexed by user id, attempt id and question id.&lt;br /&gt;
&lt;br /&gt;
===Database structure===&lt;br /&gt;
All this data needs to be kept in Moodle&#039;s database. How this is achieved is explained on a separate page about the &#039;&#039;&#039;[[Quiz database structure]]&#039;&#039;&#039;, which also contains a useful diagram.&lt;br /&gt;
&lt;br /&gt;
As is customary in Moodle, most runtime objects simply represent the data from a particular database record. So for example a $quiz object has fields corresponding to all the fields in the [[Quiz database structure#quiz|quiz table]]. In some cases the objects have some additional fields that are added at runtime. This is particularly the case for $question and $state objects. These additional fields are also described on the page about the &#039;&#039;&#039;[[Quiz database structure]]&#039;&#039;&#039;. Many functions that are used to process these objects make use of the additional fields and it is therefore necessary to use the correct functions for creating these objects.&lt;br /&gt;
&lt;br /&gt;
===Runtime objects===&lt;br /&gt;
Some objects used by the quiz module are purely runtime object and do not correspond to a database table. The structure of these objects is explained in detail on a separate page about the &#039;&#039;&#039;[[Quiz runtime objects]]&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
The main script of the quiz module is attempt.php which will have to deal with all these objects. Studying the &#039;&#039;&#039;[[Quiz attempt|explanation of attempt.php]]&#039;&#039;&#039; is therefore a good way to start to study the quiz module code.&lt;br /&gt;
&lt;br /&gt;
==Response storage==&lt;br /&gt;
&lt;br /&gt;
The student&#039;s responses to a question are stored in &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt;. Questiontypes are completely free to implement the storage mechanism of their responses (and other state information) the way they want. Still, the standard questiontypes all follow a similar model. The default storage model and the questiontype specific variations are explained below.&lt;br /&gt;
&lt;br /&gt;
The flexibility for the questiontypes to choose their response storage mechanism freely and to convert from the storage model to the runtime model is provided by a set of three functions, which allow to initialise the runtime &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; field, to convert from the runtime to the storage model and vice versa:&lt;br /&gt;
&lt;br /&gt;
;&amp;lt;code&amp;gt;create_session_and_responses()&amp;lt;/code&amp;gt;&lt;br /&gt;
:Initializes the $state object, in particular the &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; field&lt;br /&gt;
&lt;br /&gt;
;&amp;lt;code&amp;gt;restore_session_and_responses()&amp;lt;/code&amp;gt;&lt;br /&gt;
:Loads the question type specific session data from the database into the &amp;lt;code&amp;gt;$state&amp;lt;/code&amp;gt; object, in particular it loads the responses that have been saved for the given &amp;lt;code&amp;gt;$state&amp;lt;/code&amp;gt; into the &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; field.&lt;br /&gt;
&lt;br /&gt;
;&amp;lt;code&amp;gt;save_session_and_responses()&amp;lt;/code&amp;gt;&lt;br /&gt;
:Saves the question type specific session data from the $state object to the database. In particular, for most questiontypes, it saves the responses from the &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; to the database.&lt;br /&gt;
&lt;br /&gt;
The generic quiz module code saves the contents form the &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;$state-&amp;gt;responses[&#039;&#039;]&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; field to the answer field in the [[Quiz database structure#quiz_states|quiz_states table]] and also automatically restores the contents of this field to &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;$state-&amp;gt;responses[&#039;&#039;]&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;. This means that any questiontype, which only expects a single value as its response can skip the implementation of the three methods described above. All questiontypes that have multiple value responses need to implement these methods. &lt;br /&gt;
&lt;br /&gt;
The default questiontypes handle this problem by serializing/de-serializing the responses to/from the answer field in the quiz_states table. However, it is also possible (and may be better practice) to extend the quiz_states table with a questiontype specific table, i.e. take the id of the quiz_states record as a foreign key in the questiontype specific table. Because the value of &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;$state-&amp;gt;responses[&#039;&#039;]&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; is set to the value of the answer field, questiontypes that serialize their response need to overwrite (in &amp;lt;code&amp;gt;save_session_and_responses()&amp;lt;/code&amp;gt;) whatever value the generic code set this field to with their serialized value (usually achieved with a simple set_field). &lt;br /&gt;
&lt;br /&gt;
In the method &amp;lt;code&amp;gt;restore_session_and_responses()&amp;lt;/code&amp;gt; the serialized value can be read from &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;$state-&amp;gt;responses[&#039;&#039;]&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; because this is where the value from answer field of the quiz_states table has been moved. Care needs to be taken that this array value is then unset or the whole array overwritten, so that the array does not accidentally contain a value with the empty string index.&lt;br /&gt;
&lt;br /&gt;
==Response processing==&lt;br /&gt;
&lt;br /&gt;
The runtime model for responses dictates the structure of the $state-&amp;gt;responses array. Starting with the names of the form elements this section goes through the relevant processing steps and thus attempts to clarify why the keys of the $state-&amp;gt;responses array can differ for different questiontypes; even more, it explains how the array keys are chosen and set.&lt;br /&gt;
&lt;br /&gt;
Although it may initially seem strange to start with the naming convention of the form fields, the reason for this will become clear later on. The controls (i.e. the form fields) of a question get printed by the method &amp;lt;code&amp;gt;print_question_formulation_and_controls()&amp;lt;/code&amp;gt;. The convention only dictates that the name of the control element(s) must begin with the value of &amp;lt;code&amp;gt;$question-&amp;gt;name_prefix&amp;lt;/code&amp;gt;. The &amp;lt;code&amp;gt;$question-&amp;gt;name_prefix&amp;lt;/code&amp;gt; is a string starting with &amp;quot;resp&amp;quot; followed by the question id and an underscore, e.g. &amp;lt;code&amp;gt;resp56_&amp;lt;/code&amp;gt;. In the default case, when there is only a single control element (this includes the case of a list of equally named radio buttons), no postfix is appended to the name prefix. For questiontypes that allow or require multiple form elements, an arbitrary string can be appended to the name prefix to form the name of these form elements. The postfix must not include any relational data (i.e. ids of records in the quiz_answers table), because this can lead to problems with regrading of versioned questions.&lt;br /&gt;
&lt;br /&gt;
After the printing of the question the server only sees it again when it is submitted. So the submitted data will contain several values indexed by strings starting with &amp;lt;code&amp;gt;respXX_&amp;lt;/code&amp;gt;. Upon submission, the function &amp;lt;code&amp;gt;quiz_process_responses()&amp;lt;/code&amp;gt; is called, which assigns the submitted responses to the state of the question with id XX, using the postfix (i.e. everything after the underscore) as array keys. In the default case with only one control element the name only consists of the name prefix. This explains why the default index of the &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; array is the empty string. The value of each array element is obviously the value that was submitted by the form, basically a raw response.&lt;br /&gt;
&lt;br /&gt;
The function &amp;lt;code&amp;gt;quiz_process_responses()&amp;lt;/code&amp;gt; in turn calls the questiontype specific method &amp;lt;code&amp;gt;grade_responses()&amp;lt;/code&amp;gt; to assign a grade to the submitted responses and &amp;lt;code&amp;gt;compare_responses()&amp;lt;/code&amp;gt; to determine whether the response was identical to the previous submission and to avoid regrading the same responses repeatedly. These questiontype specific functions need to be aware of the expected keys of the &amp;lt;code&amp;gt;$state-&amp;gt;responses&amp;lt;/code&amp;gt; array.&lt;br /&gt;
&lt;br /&gt;
Finally, the methods &amp;lt;code&amp;gt;restore_session_and_responses()&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;save_session_and_responses()&amp;lt;/code&amp;gt; also need to know the questiontype specific layout of the &amp;lt;code&amp;gt;$state-&amp;gt;responses array&amp;lt;/code&amp;gt; and restore or save the information, e.g. by converting from or to the data representation.&lt;br /&gt;
&lt;br /&gt;
==Question types==&lt;br /&gt;
{{Questiontype developer docs}}&lt;br /&gt;
The quiz module is itself modular and allows question type plug-ins. For each question type there should be a page, accessible via the menu at the right, which provides at least the dtails about&lt;br /&gt;
*Database tables&lt;br /&gt;
*Response storage&lt;br /&gt;
*Question options object&lt;br /&gt;
*State options object&lt;br /&gt;
&lt;br /&gt;
It is hoped that Moodlers will contribute a lot of non-core question types in the future. For this it would be good to start a [[Guide to question type plugins]].&lt;br /&gt;
&lt;br /&gt;
==Grades==&lt;br /&gt;
&lt;br /&gt;
The handling of grades is a bit complicated because there are so many different grades around that get rescaled and combined in various ways. This section should summarize how this is done and why.&lt;br /&gt;
&lt;br /&gt;
The following grade fields are being used:&lt;br /&gt;
*$question-&amp;gt;defaultgrade&lt;br /&gt;
::This is the default value for the maximum grade for this question. This is set up when the teacher creates the question and it is stored in an int(10) field in the [[Quiz database structure#quiz_questions|quiz_questions]] table. However when the question is actually used in a particular quiz the teacher can overrule this default and this is stored in:&lt;br /&gt;
*$question-&amp;gt;maxgrade&lt;br /&gt;
::This is the maximum grade that the teacher has assigned to this question in the context of the current quiz. This is by default equal to $questions-&amp;gt;defaultgrade but the teacher can change this when editing the quiz. In the database it is stored in an int(10) field in the [[Quiz database structure#quiz_question_instances|quiz_question_instances table]].&lt;br /&gt;
*$question-&amp;gt;penalty&lt;br /&gt;
&lt;br /&gt;
*$state-&amp;gt;raw_grade&lt;br /&gt;
*$state-&amp;gt;grade&lt;br /&gt;
*$state-&amp;gt;penalty&lt;br /&gt;
*$state-&amp;gt;sumpenalty&lt;br /&gt;
&lt;br /&gt;
*$attempt-&amp;gt;sumgrades&lt;br /&gt;
&lt;br /&gt;
The maximum grades set by the teacher, $question-&amp;gt;defaultgrade and $question-&amp;gt;maxgrade, are integers. All student-obtained grades are in principle floating point numbers. For historical reasons they are stored in the database as varchar(10) fields. Care has to be taken when writing to the database to make sure all grades are correctly rounded and squeezed into a string of no more than 10 characters, otherwise the writing to database will fail, see bug 4220.&lt;br /&gt;
&lt;br /&gt;
The final outcome of the calculation of the grade for a user at a particular quiz is stored in the &#039;grade&#039; field of the [[Quiz database structure#quiz_grades|quiz_grades table]]. This field has type double.&lt;br /&gt;
&lt;br /&gt;
==Penalty mechanism==&lt;br /&gt;
&lt;br /&gt;
===What it is for===&lt;br /&gt;
&lt;br /&gt;
When the quiz is run in adaptive mode the student can interact with a question repeatedly. So in particular the student can try again when he gets a wrong answer. Clearly the final mark for the question must reflect the fact that the student did not get it right originally. Therefore a penalty is subtracted from the final mark.&lt;br /&gt;
&lt;br /&gt;
===How the penalty is determined===&lt;br /&gt;
&lt;br /&gt;
First of all penalties are relevant only if a quiz is run in adaptive mode. Only in this case can a student have a second attempt and therefore only in this mode can there be any occasion to subtract a penalty.&lt;br /&gt;
&lt;br /&gt;
Even in adaptive mode the penalty mechanism is only used when it is selected in the quiz options. If &amp;quot;Apply penalties&amp;quot; is set to &amp;quot;No&amp;quot; then the final mark for the question is the mark for the last graded response.&lt;br /&gt;
&lt;br /&gt;
Each question has a &#039;penalty&#039; field (which should really be called &#039;penaltyfactor&#039;) which is a number between 0 and 1. The penalty for a wrong response is calculated as the product ($quiz-&amp;gt;penalty * $quiz-&amp;gt;grade), i.e., as the product of the penaltyfactor with the maximum achievable grade for the question. This product is stored in $state-&amp;gt;penalty. So $quiz-&amp;gt;penalty is the fraction of the maximum grade that is subtracted as a penalty for each wrong response.&lt;br /&gt;
&lt;br /&gt;
The $quiz-&amp;gt;penalty field has a default value of 0.1, both in the database and in mod/quiz/defaults.php. This default can of course be overwritten by the admin on the quiz configuration page. This admin-selected default is (as usual for admin defaults) stored in $CFG-&amp;gt;quiz_penalty. The teacher can choose a different penalty factor for each individual question when adding or editing a question.&lt;br /&gt;
&lt;br /&gt;
Now if a student makes repeated wrong attempts (or partially correct attempts) the penalties for all these attempts are added up in $state-&amp;gt;sumpenalties. The mark for the question is then calculated as the mark for the last graded response minus the sum of the penalties.&lt;br /&gt;
&lt;br /&gt;
One curious fact about $state-&amp;gt;sumpenalties is that, for efficiency reasons, it is not stored in the quiz_states table but instead in the &#039;sumpenalty&#039; field of the quiz_newest_states table. That way it only has to be stored once per attempt rather than once per response.&lt;br /&gt;
&lt;br /&gt;
===Where it is done in the code===&lt;br /&gt;
&lt;br /&gt;
The function quiz_apply_penalty_and_timelimit() subtracts the penalty in $state-&amp;gt;sumpenalty from the raw grade in $state-&amp;gt;raw_grade to obtain $state-&amp;gt;grade for the response. However it is ensured that the grade of a new attempt at the question never falls below the previously achieved grade. This function also increases $state-&amp;gt;sumpenalty by the amount in $state-&amp;gt;penalty. The assumption is that $state-&amp;gt;penalty has just been set appropriately by the code calling this function, e.g., quiz_process_responses.&lt;br /&gt;
[[Category:Quiz]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=Question_formats&amp;diff=3241</id>
		<title>Question formats</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=Question_formats&amp;diff=3241"/>
		<updated>2006-04-18T06:57:19Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: +cat&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Importing and exporting have in common the data structure of questions in moodle but different requirements about the import or export modules unless the import or export is related to the same standard (ex.QTI).&lt;br /&gt;
The moodle data structure should be avalable elsewhere.&lt;br /&gt;
(to be continued)&lt;br /&gt;
[[Category:Quiz]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=Quiz_attempt&amp;diff=2057</id>
		<title>Quiz attempt</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=Quiz_attempt&amp;diff=2057"/>
		<updated>2006-04-18T06:57:09Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: +cat&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Quiz developer docs}}The attempt.php script is one of the most complicated scripts of the quiz module. It is responsible for displaying questions to a user, to evaluate and grade the users&#039; responses and additionally it needs to take various quiz settings into account and change the behaviour of the script accordingly. This script, which is vital for the functioning of the quiz module, is explained in this document in some detail in order to provide some context and examples for the use of the question/state model and to illustrate some of the functions provided in locallib.php.&lt;br /&gt;
&lt;br /&gt;
In addition to the immediate benefit of explaining what happens in attempt.php, this piece of documentation should provide an entry point to the quiz module code. A number of functions are used in attempt.php that are likely to be used in other scripts as well.&lt;br /&gt;
&lt;br /&gt;
Although the attempt.php script is useful for understanding how user interactions are handled, in order to gain an understanding of the teacher interface for editing quizzes and questions you should look at edit.php.&lt;br /&gt;
&lt;br /&gt;
== A simplified perspective ==&lt;br /&gt;
&lt;br /&gt;
From a simple functional point of view, the responsibilities of attempt.php is the handling of attempts at a quiz. This includes displaying questions and storing data provided or generated by the users. The interaction could be limited to opening the page and thus creating a new attempt and submitting the responses back to the server, which causes the responses to be graded. While the script is actually more sophisticated and allows to interrupt and continue attempts, this two step scenario provides a good starting point and covers the core functionality.&lt;br /&gt;
&lt;br /&gt;
=== Starting a new attempt ===&lt;br /&gt;
&lt;br /&gt;
When a new attempt is started the attempt object is created by the function &amp;lt;code&amp;gt;quiz_create_attempt()&amp;lt;/code&amp;gt; (line 183). It returns an empty &amp;lt;code&amp;gt; $attempt&amp;lt;/code&amp;gt; object, which is stored in the database immediately to record the fact that the student has seen the questions.&lt;br /&gt;
&lt;br /&gt;
The next step is to load up all questions and to create initial states for all of them. Loading up the questions is a two step process: first the question records are extracted from the database, then the function &amp;lt;code&amp;gt; quiz_get_questions_options()&amp;lt;/code&amp;gt; is called. This attaches the name_prefix field and calls the questiontype specific &amp;lt;code&amp;gt;get_question_options()&amp;lt;/code&amp;gt; method for each question record in order to add any required data.&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
     // Load the questions&lt;br /&gt;
     if (!$questions = get_records_sql($sql)) {&lt;br /&gt;
         ...&lt;br /&gt;
     }&lt;br /&gt;
     // Load the question type specific information&lt;br /&gt;
     if (!quiz_get_question_options($questions)) {&lt;br /&gt;
         ...&lt;br /&gt;
     }&lt;br /&gt;
     // Restore the question sessions to their most recent states&lt;br /&gt;
     // creating new sessions where required&lt;br /&gt;
     if (!$states = quiz_get_states($questions, $attempt)) {&lt;br /&gt;
         ...&lt;br /&gt;
     }&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
After all questions are correctly initialised a state object is created for each by the function &amp;lt;code&amp;gt;quiz_get_states()&amp;lt;/code&amp;gt;. This function is responsible for providing a state for each question and creates a new state if there isn&#039;t one to be restored. Any newly states are added to the database right away.&lt;br /&gt;
&lt;br /&gt;
At this point all the required data has been generated or loaded, so the last step is to print the page. The printing happens towards the end of the attempt.php script and, apart from a simple call to &amp;lt;code&amp;gt;print_heading()&amp;lt;/code&amp;gt; (line 409), is done in a loop through all the question records by calling &amp;lt;code&amp;gt; quiz_print_quiz_question()&amp;lt;/code&amp;gt; (line 461), which is just a shorthand for calling the questiontype specific &amp;lt;code&amp;gt;print_question()&amp;lt;/code&amp;gt; method. So, quite conveniently, each question is responsible for printing itself. To round up the printing, submit buttons and a footer are printed to the bottom of the page.&lt;br /&gt;
&lt;br /&gt;
=== Processing responses ===&lt;br /&gt;
&lt;br /&gt;
The next logical step after creating and displaying an attempt is that the user enters answers for all questions and submits them for marking. Now it is not necessary to create a new attempt, because there is already an open existing one in the database and the same holds for each question&#039;s state. So this time the attempt record is loaded from the database. The questions are loaded in the same way, by querying for the question records an then attaching any required questiontype specific fields by calling the function &amp;lt;code&amp;gt; quiz_get_question_options()&amp;lt;/code&amp;gt;. Now the call to the function &amp;lt;code&amp;gt; quiz_get_states()&amp;lt;/code&amp;gt; does actually restore the states from the database rather than generate new ones, so the same code works for the two scenarios, creating and closing an attempt.&lt;br /&gt;
&lt;br /&gt;
Now that all data concerning the attempt under discussion has been loaded, the responses submitted by the student come to the scene. For each question they need to be evaluated and graded. The first step here is to determine how to deal with each question and the associated responses. In the simplified case this is clear; all responses need to be graded, the grades stored and then the attempt needs to be closed. However, there are more complicated cases, so the function &amp;lt;code&amp;gt; quiz_extract_responses()&amp;lt;/code&amp;gt; is called to create the &amp;lt;code&amp;gt;$actions&amp;lt;/code&amp;gt; array, which acts as a set of instructions for the function &amp;lt;code&amp;gt;quiz_process_responses()&amp;lt;/code&amp;gt;, a quite complicated function, which encapsulates the entire response processing for one question and calls out to the questiontype specific &amp;lt;code&amp;gt;grade_responses()&amp;lt;/code&amp;gt; method for grading.&lt;br /&gt;
&lt;br /&gt;
After all submitted responses have been processed, the questions are rendered in the new states. An exception is if the student has requested to close the attempt (or if it is closed automatically due to a time limit). In this case the attempt is closed by setting the &amp;lt;code&amp;gt;timefinish&amp;lt;/code&amp;gt; field to the current time. After this the user is redirected to review.php, which, depending on the quiz review settings, shows the questions including the student&#039;s responses, feedback, grades and correct answers.&lt;br /&gt;
&lt;br /&gt;
== A more complicated perspective ==&lt;br /&gt;
&lt;br /&gt;
Before an attempt may be started there are a series of mandatory and optional checks, to determine if the user is allowed to attempt the quiz. In addition to these checks, the page display and functionality are slightly different for users with and without teacher privileges. Also, when the quiz is set to start in &amp;quot;secure&amp;quot; mode (the $quiz-&amp;gt;popup option), the printing of the page is slightly different. Including all of these scenarios evidently complicates the structure of the attempt.php script, deviating from the simple scenario described above.&lt;br /&gt;
&lt;br /&gt;
First of all, access to the quiz is denied to guests. Additionally it is possible to restrict acces to an IP range ($quiz-&amp;gt;subnet) and to set up a password for the quiz ($quiz-&amp;gt;password). In both cases users that can&#039;t pass the required tests are denied access.&lt;br /&gt;
&lt;br /&gt;
When a teacher &amp;quot;attempts&amp;quot; a quiz there is a tab navigation facility at the top of the page, which allows the teacher to jump between reviewing, previewing and editing the quiz (and possibly even more options). The teacher interface also contains a button to start a new attempt, which is not present on the student interface. Teachers&#039; attempts are automatically marked as previews, which means that old attempts are automatically deleted when a new attempt is started. It also prevents previews to show up in the students&#039; answers review and preview attempts don&#039;t block the possibility of editing the quiz, while students&#039; attempts do.&lt;br /&gt;
&lt;br /&gt;
Further complication is introduced by the feature to allow multiple pages with questions and navigation between these pages. This requieres mechanisms to determine which questions are on which page, which page is currently displayed and which page needs to be viewed next. This is not too hard to achieve, however, one subtlety should be noted: when the attempt is closed it is necessary to load all questions and their most recent states before they are marked, whereas in the case of navgation only the questions and related states of the page that was displayed before are loaded, processed and saved; and the questions and states for the next page are loaded.&lt;br /&gt;
&lt;br /&gt;
Towards the end of the script there are two blocks of code that are responsible for timed quizzes ($quiz-&amp;gt;timelimit). The first block prints the start element of the form using javascript to make sure that javascript is enabled (which obviously doesn&#039;t help a lot, because the quiz is printed as usual, only the submit won&#039;t work). The second block includes the file jstimer.php, which prints a timer that counts down and causes an auto-submit when time is up.&lt;br /&gt;
[[Category:Quiz]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22966</id>
		<title>User talk:Helen Foster</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22966"/>
		<updated>2006-04-18T06:44:58Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: /* Template styles */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== More hierarchy ==&lt;br /&gt;
&lt;br /&gt;
Hi Helen, I think this wiki is very useful and I would like to thank you for the work you are putting into it. I like your navigation boxes on the module pages. I have a suggestion for extending these: I think it would be nice to have an extra link that allows one to go higher up in the hierarcy to [[Teacher_documentation]]. What do you think? --[[User:Delius|Delius]] 17:48, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, thanks for your kind words. Your contributions to the documentation are most welcome. Please feel free to edit [[Template:Quizzes]] or any other template page. You may also wish to consider further use of category pages e.g. [[:Category:Teacher]] for navigation. -- [[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Do you monitor all talk pages? ==&lt;br /&gt;
&lt;br /&gt;
Helen, I have posted another question for you on [[Talk:mod/quiz/index]]. Do you get alerted to anything I put on any talk page or should I post on this page if I want you to see it? --[[User:Delius|Delius]] 18:01, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, please note that I often check [[Special:Recentchanges|Recent changes]] or the rss feed. --[[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Yes, the [[Special:Recentchanges|Recent changes]] page is very useful. You can tell that I have never used a wiki intensively before. Thanks for your tips. --[[User:Gustav|Gustav]] 18:35, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:::Hey, let&#039;s discover the wiki way together! :-) --[[User:Helen|Helen]] 00:24, 27 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Moodle profile==&lt;br /&gt;
&lt;br /&gt;
Helen- I think you should link to your moodle profile like Martin does (assuming you have one, which I assume &amp;lt;grin&amp;gt;). -- D.I. 29Jan06&lt;br /&gt;
Wow, you&#039;re fast.. .or I&#039;m confused. --D.I. 29Jan06&lt;br /&gt;
&lt;br /&gt;
:Hi D.I. thanks for your suggestion, which [[User:UrsHunkler|someone else]] seem to be following up! ;-) --[[User:Helen|Helen]] 05:00, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German moodle docs possible? ==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
&lt;br /&gt;
thank you very much for these nice and structured doc pages.&lt;br /&gt;
When do you plan to launch a german part of the docs.moodle.org pages?&lt;br /&gt;
I ask these question because i can translate some of the english doc pages to german.&lt;br /&gt;
&lt;br /&gt;
Greetings Christoph&lt;br /&gt;
&lt;br /&gt;
:Hi Christoph, thanks for your kind offer of translation. Please email &#039;&#039;docs AT moodle DOT org&#039;&#039; so I may get in touch with you easily when the German Moodle documentation is launched. --[[User:Helen|Helen]] 05:17, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German User Docs ==&lt;br /&gt;
&lt;br /&gt;
Thanks a lot, Helen, for all your work. &lt;br /&gt;
I would also like to help with the German version. &lt;br /&gt;
&lt;br /&gt;
Ulrike&lt;br /&gt;
&lt;br /&gt;
:Hi Ulrike, thanks for your kind offer too. MoodleDocs in other languages will happen soon, for sure! --[[User:Helen|Helen]] 08:30, 31 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Documentation for different versions ==&lt;br /&gt;
&lt;br /&gt;
Helen&lt;br /&gt;
&lt;br /&gt;
Is there a mechanism for specifying which version of Moodle a particular document refers to?  If, for instance, a feature is only available in version 1.6, how would a 1.5.3 user know they couldn&#039;t follow these instructions?&lt;br /&gt;
&lt;br /&gt;
Equally, if something is done differently in two versions, how would we stop an edit war breaking out between 1.5.3 and 1.6 users?&lt;br /&gt;
&lt;br /&gt;
I appreciate this probably isn&#039;t an issue just yet, but it&#039;s possible it may become one in later versions.&lt;br /&gt;
&lt;br /&gt;
Cheers,&lt;br /&gt;
&lt;br /&gt;
[[User:CHRISF|CHRISF]] 19:20, 1 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi ChrisF, thanks for highlighting the issue of differences in Moodle versions. Perhaps a Moodle 1.6 template, inserted using the code &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;{{Moodle 1.6}}&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;, may be used to show features specific to Moodle 1.6. What do you think? --[[User:Helen|Helen]] 04:22, 4 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Good idea.  I think that would clear it up nicely.  [[User:CHRISF|CHRISF]] 18:08, 7 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Hungarian Moodle Docs==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
I may be knocking at the wrong door.&lt;br /&gt;
Could you please create a folder for me to start Moodle documentation in Hungarian please?&lt;br /&gt;
Thanks a lot.&lt;br /&gt;
Karoly&lt;br /&gt;
&lt;br /&gt;
(Karoly Fabricz, kfabricz AT vnet DOT hu)&lt;br /&gt;
&lt;br /&gt;
:Hi Karoly, thanks for your kind offer. Please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]]. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Belarusian Docs is possible? ==&lt;br /&gt;
&lt;br /&gt;
Dear Helen,&lt;br /&gt;
&lt;br /&gt;
I would like to manage Moodle documentation on Belarusian. Could you create a folder for me to start Moodle documentation in Belarusian, please? Аlphabetic acronym of Belarusian language is be.&lt;br /&gt;
&lt;br /&gt;
Sincerely,&lt;br /&gt;
Maryia Davidouskaia&lt;br /&gt;
(maryia at iatp dot by)&lt;br /&gt;
&lt;br /&gt;
:Hi Maryia, thanks for your kind offer. As I said to Karoly, please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]], and remember that the more people that are involved in creating the documentation, the better it will be. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
Ok, You are a STAR!&lt;br /&gt;
&lt;br /&gt;
== Template styles ==&lt;br /&gt;
Hi Helen! I noticed that you reverted my edits on [[Template:Book]] and [[Template:Assignments]]. You were right -- I didn&#039;t realise that the [[MoodleDocs:Styling|style]] doesn&#039;t match [[MoodleDocs:Style guide|moodle.org style]]. However, the current template doesn&#039;t look right either. It should float to the right instead of occupying a substantial part of the upper screen (for eg. on [[Calculated question developer docs]] page) -- this wil provide easier navigation. Also, the tempalate should be colorful and/or bordered -- this looks more attractive and the reader can understand that it is not a part of the article. May be we can have orange or similar colored templates (such as [[Template:Large Installations]] and [[Template:excerpted from Jason Cole]]) that match with moodle.org style? Is there any official style documentation? Is there a moodle.org style guide which describes styles for templates -- I couldn&#039;t find one? [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 17:40, 30 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Utkarshraj, thanks for your contributions to Moodle Docs. As you&#039;ve found, [[MoodleDocs:Style guide]] and [[MoodleDocs:Styling]] contain all the Moodle Docs styling documentation to-date. Please add your comments about template styling to [[MoodleDocs talk:Styling]]. --[[User:Helen Foster|Helen Foster]] 17:26, 31 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Thank you! I&#039;ve started the discussion at [[MoodleDocs talk:Styling]]. [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 19:14, 31 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:::LoL, I just realized that the problem is not with the templates, but with themes. Templates just look find with the MoodleDocs theme, but when I am logged in, I use MonoBook theme -- it doesn&#039;t display them as right-aligned (at Wikipedia, we explicity make the templates right-aligned). Sorry for wasting your time! [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 14:44, 18 April 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Slovak Moodle Documentation ==&lt;br /&gt;
&lt;br /&gt;
Hi, Helen. We would like to start work on translation on Moodle Slovak (sk) documentation. Please, do you think is it possible? Thank you.&lt;br /&gt;
&lt;br /&gt;
Sincerely, Juraj Chlebec&lt;br /&gt;
havran@gmail.com&lt;br /&gt;
&lt;br /&gt;
:Hi Juraj, thanks for your offer. Please note that, for non iso-8859-1 languages we need to wait for moodle.org to be converted to UTF-8 (since Moodle Docs authenticates against moodle.org) before setting things up. I&#039;ll be in contact when this is done. --[[User:Helen Foster|Helen Foster]] 22:05, 10 April 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Polish Moodle Documentation ==&lt;br /&gt;
&lt;br /&gt;
Hello, Helen. I saw Your comments to Juraj&#039;s post, so just want to let you know that we are ready to start polish translation. Hope the situation will change soon.&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram/temp&amp;diff=19795</id>
		<title>User:Utkarshraj Atmaram/temp</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram/temp&amp;diff=19795"/>
		<updated>2006-04-06T04:13:18Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: test template style&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{| align=right id=toc style=&amp;quot;margin-left: 15px; background-color: #ffffff; border: 5px solid #ffc240&amp;quot;&lt;br /&gt;
!align=center style=&amp;quot;border-bottom: 1px solid #ffc240&amp;quot; |&#039;&#039;&#039;[[Assignments]]&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
| [[Adding/editing an assignment]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Assignment details]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Viewing an assignment]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Assignment submissions]]&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19766</id>
		<title>User:Utkarshraj Atmaram</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19766"/>
		<updated>2006-04-06T04:09:15Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: fix link&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;*[http://moodle.org/user/view.php?id=6591&amp;amp;course=5 My Moodle Personal Profile]&lt;br /&gt;
*[http://en.wikipedia.org/wiki/User:Utcursch My Wikipedia page]&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
[[User:Utkarshraj Atmaram/temp|Template test]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19765</id>
		<title>User:Utkarshraj Atmaram</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19765"/>
		<updated>2006-04-06T04:08:31Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: template test&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;*[http://moodle.org/user/view.php?id=6591&amp;amp;course=5 My Moodle Personal Profile]&lt;br /&gt;
*[http://en.wikipedia.org/wiki/User:Utcursch My Wikipedia page]&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
[[User:Utcursch/temp|Template test]]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22961</id>
		<title>User talk:Helen Foster</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22961"/>
		<updated>2006-03-31T11:14:31Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: /* Template styles */ thanks&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== More hierarchy ==&lt;br /&gt;
&lt;br /&gt;
Hi Helen, I think this wiki is very useful and I would like to thank you for the work you are putting into it. I like your navigation boxes on the module pages. I have a suggestion for extending these: I think it would be nice to have an extra link that allows one to go higher up in the hierarcy to [[Teacher_documentation]]. What do you think? --[[User:Delius|Delius]] 17:48, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, thanks for your kind words. Your contributions to the documentation are most welcome. Please feel free to edit [[Template:Quizzes]] or any other template page. You may also wish to consider further use of category pages e.g. [[:Category:Teacher]] for navigation. -- [[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Do you monitor all talk pages? ==&lt;br /&gt;
&lt;br /&gt;
Helen, I have posted another question for you on [[Talk:mod/quiz/index]]. Do you get alerted to anything I put on any talk page or should I post on this page if I want you to see it? --[[User:Delius|Delius]] 18:01, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, please note that I often check [[Special:Recentchanges|Recent changes]] or the rss feed. --[[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Yes, the [[Special:Recentchanges|Recent changes]] page is very useful. You can tell that I have never used a wiki intensively before. Thanks for your tips. --[[User:Gustav|Gustav]] 18:35, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:::Hey, let&#039;s discover the wiki way together! :-) --[[User:Helen|Helen]] 00:24, 27 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Moodle profile==&lt;br /&gt;
&lt;br /&gt;
Helen- I think you should link to your moodle profile like Martin does (assuming you have one, which I assume &amp;lt;grin&amp;gt;). -- D.I. 29Jan06&lt;br /&gt;
Wow, you&#039;re fast.. .or I&#039;m confused. --D.I. 29Jan06&lt;br /&gt;
&lt;br /&gt;
:Hi D.I. thanks for your suggestion, which [[User:UrsHunkler|someone else]] seem to be following up! ;-) --[[User:Helen|Helen]] 05:00, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German moodle docs possible? ==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
&lt;br /&gt;
thank you very much for these nice and structured doc pages.&lt;br /&gt;
When do you plan to launch a german part of the docs.moodle.org pages?&lt;br /&gt;
I ask these question because i can translate some of the english doc pages to german.&lt;br /&gt;
&lt;br /&gt;
Greetings Christoph&lt;br /&gt;
&lt;br /&gt;
:Hi Christoph, thanks for your kind offer of translation. Please email &#039;&#039;docs AT moodle DOT org&#039;&#039; so I may get in touch with you easily when the German Moodle documentation is launched. --[[User:Helen|Helen]] 05:17, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German User Docs ==&lt;br /&gt;
&lt;br /&gt;
Thanks a lot, Helen, for all your work. &lt;br /&gt;
I would also like to help with the German version. &lt;br /&gt;
&lt;br /&gt;
Ulrike&lt;br /&gt;
&lt;br /&gt;
:Hi Ulrike, thanks for your kind offer too. MoodleDocs in other languages will happen soon, for sure! --[[User:Helen|Helen]] 08:30, 31 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Documentation for different versions ==&lt;br /&gt;
&lt;br /&gt;
Helen&lt;br /&gt;
&lt;br /&gt;
Is there a mechanism for specifying which version of Moodle a particular document refers to?  If, for instance, a feature is only available in version 1.6, how would a 1.5.3 user know they couldn&#039;t follow these instructions?&lt;br /&gt;
&lt;br /&gt;
Equally, if something is done differently in two versions, how would we stop an edit war breaking out between 1.5.3 and 1.6 users?&lt;br /&gt;
&lt;br /&gt;
I appreciate this probably isn&#039;t an issue just yet, but it&#039;s possible it may become one in later versions.&lt;br /&gt;
&lt;br /&gt;
Cheers,&lt;br /&gt;
&lt;br /&gt;
[[User:CHRISF|CHRISF]] 19:20, 1 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi ChrisF, thanks for highlighting the issue of differences in Moodle versions. Perhaps a [[Template:Moodle 1.6|Moodle 1.6 template]], inserted using the code &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;{{Moodle 1.6}}&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;, may be used to show features specific to Moodle 1.6. What do you think? --[[User:Helen|Helen]] 04:22, 4 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Good idea.  I think that would clear it up nicely.  [[User:CHRISF|CHRISF]] 18:08, 7 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Hungarian Moodle Docs==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
I may be knocking at the wrong door.&lt;br /&gt;
Could you please create a folder for me to start Moodle documentation in Hungarian please?&lt;br /&gt;
Thanks a lot.&lt;br /&gt;
Karoly&lt;br /&gt;
&lt;br /&gt;
(Karoly Fabricz, kfabricz AT vnet DOT hu)&lt;br /&gt;
&lt;br /&gt;
:Hi Karoly, thanks for your kind offer. Please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]]. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Belarusian Docs is possible? ==&lt;br /&gt;
&lt;br /&gt;
Dear Helen,&lt;br /&gt;
&lt;br /&gt;
I would like to manage Moodle documentation on Belarusian. Could you create a folder for me to start Moodle documentation in Belarusian, please? Аlphabetic acronym of Belarusian language is be.&lt;br /&gt;
&lt;br /&gt;
Sincerely,&lt;br /&gt;
Maryia Davidouskaia&lt;br /&gt;
(maryia at iatp dot by)&lt;br /&gt;
&lt;br /&gt;
:Hi Maryia, thanks for your kind offer. As I said to Karoly, please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]], and remember that the more people that are involved in creating the documentation, the better it will be. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
Ok, You are a STAR!&lt;br /&gt;
&lt;br /&gt;
== Template styles ==&lt;br /&gt;
Hi Helen! I noticed that you reverted my edits on [[Template:Book]] and [[Template:Assignments]]. You were right -- I didn&#039;t realise that the [[MoodleDocs:Styling|style]] doesn&#039;t match [[MoodleDocs:Style guide|moodle.org style]]. However, the current template doesn&#039;t look right either. It should float to the right instead of occupying a substantial part of the upper screen (for eg. on [[Calculated question developer docs]] page) -- this wil provide easier navigation. Also, the tempalate should be colorful and/or bordered -- this looks more attractive and the reader can understand that it is not a part of the article. May be we can have orange or similar colored templates (such as [[Template:Large Installations]] and [[Template:excerpted from Jason Cole]]) that match with moodle.org style? Is there any official style documentation? Is there a moodle.org style guide which describes styles for templates -- I couldn&#039;t find one? [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 17:40, 30 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Utkarshraj, thanks for your contributions to Moodle Docs. As you&#039;ve found, [[MoodleDocs:Style guide]] and [[MoodleDocs:Styling]] contain all the Moodle Docs styling documentation to-date. Please add your comments about template styling to [[MoodleDocs talk:Styling]]. --[[User:Helen Foster|Helen Foster]] 17:26, 31 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Thank you! I&#039;ve started the discussion at [[MoodleDocs talk:Styling]]. [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 19:14, 31 March 2006 (WST)&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22955</id>
		<title>User talk:Helen Foster</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22955"/>
		<updated>2006-03-30T09:40:59Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: /* Template styles */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== More hierarchy ==&lt;br /&gt;
&lt;br /&gt;
Hi Helen, I think this wiki is very useful and I would like to thank you for the work you are putting into it. I like your navigation boxes on the module pages. I have a suggestion for extending these: I think it would be nice to have an extra link that allows one to go higher up in the hierarcy to [[Teacher_documentation]]. What do you think? --[[User:Delius|Delius]] 17:48, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, thanks for your kind words. Your contributions to the documentation are most welcome. Please feel free to edit [[Template:Quizzes]] or any other template page. You may also wish to consider further use of category pages e.g. [[:Category:Teacher]] for navigation. -- [[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Do you monitor all talk pages? ==&lt;br /&gt;
&lt;br /&gt;
Helen, I have posted another question for you on [[Talk:mod/quiz/index]]. Do you get alerted to anything I put on any talk page or should I post on this page if I want you to see it? --[[User:Delius|Delius]] 18:01, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, please note that I often check [[Special:Recentchanges|Recent changes]] or the rss feed. --[[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Yes, the [[Special:Recentchanges|Recent changes]] page is very useful. You can tell that I have never used a wiki intensively before. Thanks for your tips. --[[User:Gustav|Gustav]] 18:35, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:::Hey, let&#039;s discover the wiki way together! :-) --[[User:Helen|Helen]] 00:24, 27 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Moodle profile==&lt;br /&gt;
&lt;br /&gt;
Helen- I think you should link to your moodle profile like Martin does (assuming you have one, which I assume &amp;lt;grin&amp;gt;). -- D.I. 29Jan06&lt;br /&gt;
Wow, you&#039;re fast.. .or I&#039;m confused. --D.I. 29Jan06&lt;br /&gt;
&lt;br /&gt;
:Hi D.I. thanks for your suggestion, which [[User:UrsHunkler|someone else]] seem to be following up! ;-) --[[User:Helen|Helen]] 05:00, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German moodle docs possible? ==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
&lt;br /&gt;
thank you very much for these nice and structured doc pages.&lt;br /&gt;
When do you plan to launch a german part of the docs.moodle.org pages?&lt;br /&gt;
I ask these question because i can translate some of the english doc pages to german.&lt;br /&gt;
&lt;br /&gt;
Greetings Christoph&lt;br /&gt;
&lt;br /&gt;
:Hi Christoph, thanks for your kind offer of translation. Please email &#039;&#039;docs AT moodle DOT org&#039;&#039; so I may get in touch with you easily when the German Moodle documentation is launched. --[[User:Helen|Helen]] 05:17, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German User Docs ==&lt;br /&gt;
&lt;br /&gt;
Thanks a lot, Helen, for all your work. &lt;br /&gt;
I would also like to help with the German version. &lt;br /&gt;
&lt;br /&gt;
Ulrike&lt;br /&gt;
&lt;br /&gt;
:Hi Ulrike, thanks for your kind offer too. MoodleDocs in other languages will happen soon, for sure! --[[User:Helen|Helen]] 08:30, 31 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Documentation for different versions ==&lt;br /&gt;
&lt;br /&gt;
Helen&lt;br /&gt;
&lt;br /&gt;
Is there a mechanism for specifying which version of Moodle a particular document refers to?  If, for instance, a feature is only available in version 1.6, how would a 1.5.3 user know they couldn&#039;t follow these instructions?&lt;br /&gt;
&lt;br /&gt;
Equally, if something is done differently in two versions, how would we stop an edit war breaking out between 1.5.3 and 1.6 users?&lt;br /&gt;
&lt;br /&gt;
I appreciate this probably isn&#039;t an issue just yet, but it&#039;s possible it may become one in later versions.&lt;br /&gt;
&lt;br /&gt;
Cheers,&lt;br /&gt;
&lt;br /&gt;
[[User:CHRISF|CHRISF]] 19:20, 1 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi ChrisF, thanks for highlighting the issue of differences in Moodle versions. Perhaps a [[Template:Moodle 1.6|Moodle 1.6 template]], inserted using the code &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;{{Moodle 1.6}}&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;, may be used to show features specific to Moodle 1.6. What do you think? --[[User:Helen|Helen]] 04:22, 4 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Good idea.  I think that would clear it up nicely.  [[User:CHRISF|CHRISF]] 18:08, 7 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Hungarian Moodle Docs==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
I may be knocking at the wrong door.&lt;br /&gt;
Could you please create a folder for me to start Moodle documentation in Hungarian please?&lt;br /&gt;
Thanks a lot.&lt;br /&gt;
Karoly&lt;br /&gt;
&lt;br /&gt;
(Karoly Fabricz, kfabricz AT vnet DOT hu)&lt;br /&gt;
&lt;br /&gt;
:Hi Karoly, thanks for your kind offer. Please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]]. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Belarusian Docs is possible? ==&lt;br /&gt;
&lt;br /&gt;
Dear Helen,&lt;br /&gt;
&lt;br /&gt;
I would like to manage Moodle documentation on Belarusian. Could you create a folder for me to start Moodle documentation in Belarusian, please? Аlphabetic acronym of Belarusian language is be.&lt;br /&gt;
&lt;br /&gt;
Sincerely,&lt;br /&gt;
Maryia Davidouskaia&lt;br /&gt;
(maryia at iatp dot by)&lt;br /&gt;
&lt;br /&gt;
:Hi Maryia, thanks for your kind offer. As I said to Karoly, please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]], and remember that the more people that are involved in creating the documentation, the better it will be. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
Ok, You are a STAR!&lt;br /&gt;
&lt;br /&gt;
== Template styles ==&lt;br /&gt;
Hi Helen! I noticed that you reverted my edits on [[Template:Book]] and [[Template:Assignments]]. You were right -- I didn&#039;t realise that the [[MoodleDocs:Styling|style]] doesn&#039;t match [[MoodleDocs:Style guide|moodle.org style]]. However, the current template doesn&#039;t look right either. It should float to the right instead of occupying a substantial part of the upper screen (for eg. on [[Calculated question developer docs]] page) -- this wil provide easier navigation. Also, the tempalate should be colorful and/or bordered -- this looks more attractive and the reader can understand that it is not a part of the article. May be we can have orange or similar colored templates (such as [[Template:Large Installations]] and [[Template:excerpted from Jason Cole]]) that match with moodle.org style? Is there any official style documentation? Is there a moodle.org style guide which describes styles for templates -- I couldn&#039;t find one? [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 17:40, 30 March 2006 (WST)&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22954</id>
		<title>User talk:Helen Foster</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Helen_Foster&amp;diff=22954"/>
		<updated>2006-03-30T09:40:36Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: Template styles&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== More hierarchy ==&lt;br /&gt;
&lt;br /&gt;
Hi Helen, I think this wiki is very useful and I would like to thank you for the work you are putting into it. I like your navigation boxes on the module pages. I have a suggestion for extending these: I think it would be nice to have an extra link that allows one to go higher up in the hierarcy to [[Teacher_documentation]]. What do you think? --[[User:Delius|Delius]] 17:48, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, thanks for your kind words. Your contributions to the documentation are most welcome. Please feel free to edit [[Template:Quizzes]] or any other template page. You may also wish to consider further use of category pages e.g. [[:Category:Teacher]] for navigation. -- [[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Do you monitor all talk pages? ==&lt;br /&gt;
&lt;br /&gt;
Helen, I have posted another question for you on [[Talk:mod/quiz/index]]. Do you get alerted to anything I put on any talk page or should I post on this page if I want you to see it? --[[User:Delius|Delius]] 18:01, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi Gustav, please note that I often check [[Special:Recentchanges|Recent changes]] or the rss feed. --[[User:Helen|Helen]] 18:26, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Yes, the [[Special:Recentchanges|Recent changes]] page is very useful. You can tell that I have never used a wiki intensively before. Thanks for your tips. --[[User:Gustav|Gustav]] 18:35, 26 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:::Hey, let&#039;s discover the wiki way together! :-) --[[User:Helen|Helen]] 00:24, 27 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Moodle profile==&lt;br /&gt;
&lt;br /&gt;
Helen- I think you should link to your moodle profile like Martin does (assuming you have one, which I assume &amp;lt;grin&amp;gt;). -- D.I. 29Jan06&lt;br /&gt;
Wow, you&#039;re fast.. .or I&#039;m confused. --D.I. 29Jan06&lt;br /&gt;
&lt;br /&gt;
:Hi D.I. thanks for your suggestion, which [[User:UrsHunkler|someone else]] seem to be following up! ;-) --[[User:Helen|Helen]] 05:00, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German moodle docs possible? ==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
&lt;br /&gt;
thank you very much for these nice and structured doc pages.&lt;br /&gt;
When do you plan to launch a german part of the docs.moodle.org pages?&lt;br /&gt;
I ask these question because i can translate some of the english doc pages to german.&lt;br /&gt;
&lt;br /&gt;
Greetings Christoph&lt;br /&gt;
&lt;br /&gt;
:Hi Christoph, thanks for your kind offer of translation. Please email &#039;&#039;docs AT moodle DOT org&#039;&#039; so I may get in touch with you easily when the German Moodle documentation is launched. --[[User:Helen|Helen]] 05:17, 30 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== German User Docs ==&lt;br /&gt;
&lt;br /&gt;
Thanks a lot, Helen, for all your work. &lt;br /&gt;
I would also like to help with the German version. &lt;br /&gt;
&lt;br /&gt;
Ulrike&lt;br /&gt;
&lt;br /&gt;
:Hi Ulrike, thanks for your kind offer too. MoodleDocs in other languages will happen soon, for sure! --[[User:Helen|Helen]] 08:30, 31 January 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Documentation for different versions ==&lt;br /&gt;
&lt;br /&gt;
Helen&lt;br /&gt;
&lt;br /&gt;
Is there a mechanism for specifying which version of Moodle a particular document refers to?  If, for instance, a feature is only available in version 1.6, how would a 1.5.3 user know they couldn&#039;t follow these instructions?&lt;br /&gt;
&lt;br /&gt;
Equally, if something is done differently in two versions, how would we stop an edit war breaking out between 1.5.3 and 1.6 users?&lt;br /&gt;
&lt;br /&gt;
I appreciate this probably isn&#039;t an issue just yet, but it&#039;s possible it may become one in later versions.&lt;br /&gt;
&lt;br /&gt;
Cheers,&lt;br /&gt;
&lt;br /&gt;
[[User:CHRISF|CHRISF]] 19:20, 1 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
:Hi ChrisF, thanks for highlighting the issue of differences in Moodle versions. Perhaps a [[Template:Moodle 1.6|Moodle 1.6 template]], inserted using the code &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;{{Moodle 1.6}}&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;, may be used to show features specific to Moodle 1.6. What do you think? --[[User:Helen|Helen]] 04:22, 4 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
::Good idea.  I think that would clear it up nicely.  [[User:CHRISF|CHRISF]] 18:08, 7 February 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
==Hungarian Moodle Docs==&lt;br /&gt;
&lt;br /&gt;
Hello Helen,&lt;br /&gt;
I may be knocking at the wrong door.&lt;br /&gt;
Could you please create a folder for me to start Moodle documentation in Hungarian please?&lt;br /&gt;
Thanks a lot.&lt;br /&gt;
Karoly&lt;br /&gt;
&lt;br /&gt;
(Karoly Fabricz, kfabricz AT vnet DOT hu)&lt;br /&gt;
&lt;br /&gt;
:Hi Karoly, thanks for your kind offer. Please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]]. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
== Belarusian Docs is possible? ==&lt;br /&gt;
&lt;br /&gt;
Dear Helen,&lt;br /&gt;
&lt;br /&gt;
I would like to manage Moodle documentation on Belarusian. Could you create a folder for me to start Moodle documentation in Belarusian, please? Аlphabetic acronym of Belarusian language is be.&lt;br /&gt;
&lt;br /&gt;
Sincerely,&lt;br /&gt;
Maryia Davidouskaia&lt;br /&gt;
(maryia at iatp dot by)&lt;br /&gt;
&lt;br /&gt;
:Hi Maryia, thanks for your kind offer. As I said to Karoly, please read the information on [[MoodleDocs:Starting MoodleDocs|starting Moodle Docs in another language]], and remember that the more people that are involved in creating the documentation, the better it will be. I&#039;ll be in touch soon. --[[User:Helen Foster|Helen Foster]] 17:09, 15 March 2006 (WST)&lt;br /&gt;
&lt;br /&gt;
Ok, You are a STAR!&lt;br /&gt;
&lt;br /&gt;
== Template styles ==&lt;br /&gt;
&lt;br /&gt;
Hi Helen! I noticed that you reverted chat[[Template:Book]] and [[Template:Assignments]]. You were right -- I didn&#039;t realise that the [[MoodleDocs:Styling|style]] doesn&#039;t match [[MoodleDocs:Style guide|moodle.org style]]. However, the current template doesn&#039;t look right either. It should float to the right instead of occupying a substantial part of the upper screen (for eg. on [[Calculated question developer docs]] page) -- this wil provide easier navigation. Also, the tempalate should be colorful and/or bordered -- this looks more attractive and the reader can understand that it is not a part of the article. May be we can have orange or similar colored templates (such as [[Template:Large Installations]] and [[Template:excerpted from Jason Cole]]) that match with moodle.org style? Is there any official style documentation? Is there a moodle.org style guide which describes styles for templates -- I couldn&#039;t find one? [[User:Utkarshraj Atmaram|Utkarshraj Atmaram]] 17:40, 30 March 2006 (WST)&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19764</id>
		<title>User:Utkarshraj Atmaram</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utkarshraj_Atmaram&amp;diff=19764"/>
		<updated>2006-03-24T10:43:53Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;*[http://moodle.org/user/view.php?id=6591&amp;amp;course=5 My Moodle Personal Profile]&lt;br /&gt;
*[http://en.wikipedia.org/wiki/User:Utcursch My Wikipedia page]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19456</id>
		<title>User:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19456"/>
		<updated>2006-02-13T12:17:06Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Debian User, [http://en.wikipedia.org/wiki/User:Utcursch Wikipedia Administrator]&lt;br /&gt;
&lt;br /&gt;
Here is my moodle site: http://moodle.dbit.in&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22928</id>
		<title>User talk:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22928"/>
		<updated>2005-09-15T12:42:16Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;Please sign your messages. You can sign using four tildes: &amp;lt;nowiki&amp;gt;~~~~&amp;lt;/nowiki&amp;gt;&#039;&#039;&#039;. [[User:Utcursch|Utcursch]] 15 September 2005 12:42 (WST) (This is my sign)&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22927</id>
		<title>User talk:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User_talk:Utcursch&amp;diff=22927"/>
		<updated>2005-09-15T12:41:27Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: sign&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;Please sign your messages. You can sign using four tildes: &amp;lt;nowiki&amp;gt;~~~~&amp;lt;/nowiki&amp;gt;&#039;&#039;&#039;.&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
	<entry>
		<id>https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19455</id>
		<title>User:Utcursch</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/dev/index.php?title=User:Utcursch&amp;diff=19455"/>
		<updated>2005-09-15T11:30:58Z</updated>

		<summary type="html">&lt;p&gt;Utcursch: about myself&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Debian User, [http://en.wikipedia.org/wiki/User:Utcursch Wikipedia Administrator]&lt;/div&gt;</summary>
		<author><name>Utcursch</name></author>
	</entry>
</feed>