Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Question Engine 2.

Development:Question Engine 2: Difference between revisions

From MoodleDocs
No edit summary
mNo edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:Question_engine_2}}
There are some long-standing problems at the heart of the Moodle quiz module. Some design decisions that made sense when the quiz was started in the Moodle 1.1 days that are creaking at the seams now, because the quiz and question system has expanded so much.
There are some long-standing problems at the heart of the Moodle quiz module. Some design decisions that made sense when the quiz was started in the Moodle 1.1 days that are creaking at the seams now, because the quiz and question system has expanded so much.


Line 14: Line 15:
* [[Development:Question Engine 2:Rationale|Why this change is needed?]]
* [[Development:Question Engine 2:Rationale|Why this change is needed?]]
* [[Development:Question Engine 2:How the question engine currently works|How the question engine currently works]] - this may help you understand the new design.
* [[Development:Question Engine 2:How the question engine currently works|How the question engine currently works]] - this may help you understand the new design.
* [[Development:Question Engine 2:Overview|Overview of the new system]] <- '''If you only have time to read on bit, read this!'''
* [[Development:Question Engine 2:Overview|Overview of the new system]] <- '''If you only have time to read one bit, read this!'''
* [[Development:Question Engine 2:Design|Detailed design]]
* [[Development:Question Engine 2:Design|Detailed design]]
* Developer documentation that will apply once the new system is finished:
* Developer documentation that will apply once the new system is finished:
** [[Development:Developing a Question Interaction Model|Developing a Question Interaction Model]]
** [[Development:Overview of the Moodle question engine|Overview of the Moodle question engine]]
** [[Development:Developing a Question Behaviour|Developing a Question Behaviour]]
** [[Development:Developing a Question Type|Developing a Question Type]]
** [[Development:Developing a Question Type|Developing a Question Type]]
** [[Development:Using the question engine from module|Using the question engine from a module]]
** [[Development:Using the question engine from module|Using the question engine from a module]]
Line 24: Line 26:
==See also==
==See also==


* Tracker issue: MDL-20636
* Work in progress is down-loadable from github: http://timhunt.github.com/Moodle-Question-Engine-2/
* Work in progress is down-loadable from github: http://timhunt.github.com/Moodle-Question-Engine-2/
* The place to discuss this is the [http://moodle.org/mod/forum/view.php?f=121 quiz forum]. You might like to use [http://moodle.org/mod/forum/discuss.php?d=134156 this thread].
* The place to discuss this is the [http://moodle.org/mod/forum/view.php?f=121 quiz forum]. You might like to use [http://moodle.org/mod/forum/discuss.php?d=134156 this thread].
Line 30: Line 33:
* [[Development:Question_database_structure|Existing question engine developer docs]].
* [[Development:Question_database_structure|Existing question engine developer docs]].
* [[Development:Goals_of_an_online_assessment_system|Overview of high-level goals for the Moodle question engine]].
* [[Development:Goals_of_an_online_assessment_system|Overview of high-level goals for the Moodle question engine]].
 
* [[Development:Question Engine 2:Developing the Multianswer (Cloze) Question Type|Developing the Multianswer (Cloze)  Question Type]]
{{CategoryDeveloper}}
[[Category:Quiz]]

Latest revision as of 11:46, 9 November 2010

Template:Question engine 2 There are some long-standing problems at the heart of the Moodle quiz module. Some design decisions that made sense when the quiz was started in the Moodle 1.1 days that are creaking at the seams now, because the quiz and question system has expanded so much.

The main problems are

  • The database structure is not normalised. This leads to robustness issues, particularly on overloaded MySQL servers.
  • As features like adaptive mode and each attempt builds on last were added, the code has evolved into spaghetti.
  • And we want to add yet more things like certainty based marking.
  • It is more work than it should be create a new question type, and (judging by forum threads) the API is confusing.
  • It is difficult to use questions in other modules like lesson.

These are explained in more detail in Why this change is needed? below.

This is a large proposal, so I have broken it down into sections. The Design is the key part. The other sections support that.

See also