Writing Moodle Questions - Revision history

BenFranske at 01:35, 20 August 2016

2016-08-20T01:35:36Z

@@ Line 1: / Line 1: @@
-Moodle is the Learning Management System used on the ITC CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentation can be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.
+Moodle is the Learning Management System used on the ITC CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentation can be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions. In some classes only certain types of questions are accepted by your instructor, check your assignment page specific to your class to find out what question types are allowed.
-=General Information=
+=How to Write Test Questions 101=
 There are three main sections to a Moodle question: the question name, the question and the answer section. The answer section should also include feedback about why the answer is correct or incorrect and where the answer can be verified.

BenFranske at 19:49, 28 August 2013

2013-08-28T19:49:48Z

← Older revision		Revision as of 19:49, 28 August 2013
Line 1:		Line 1:
	Moodle is the Learning Management System used on the ~~CNT~~ CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentation can be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.		Moodle is the Learning Management System used on the ITC CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentation can be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.

	=General Information=		=General Information=

BenFranske: /* True/False Questions */

2012-02-07T04:35:32Z

True/False Questions

← Older revision		Revision as of 04:35, 7 February 2012
Line 67:		Line 67:

	==True/False Questions==		==True/False Questions==
	True/False questions are easily created on a single line but should be used sparingly.		True/False questions are easily created on a single line but should be used sparingly. If you are editing an existing question pool no more than 10% of the questions should be true/false. If you are writing new questions follow the information from your instructor about how many of your questions may be true/false.

	True Statement Example:		True Statement Example:
	::Apple sold personal computers before IBM did.::Apple sold personal computers before IBM did.{TRUE#The Apple I came before the IBM PC.}		::Apple sold personal computers before IBM did.::Apple sold personal computers before IBM did.{TRUE#The Apple I came before the IBM PC.}

BenFranske: /* Matching Questions */

2012-02-07T04:29:29Z

Matching Questions

← Older revision		Revision as of 04:29, 7 February 2012
Line 60:		Line 60:
	// This question is asking about the filesystems used by various operating systems		// This question is asking about the filesystems used by various operating systems
	::Match the following filesystems with their features.::Match the following filesystems with their features. {		::Match the following filesystems with their features.::Match the following filesystems with their features. {
	=A non-journaling popular Linux filesystem -> ext2~~#ext2 is the traditional Linux native filesystem (Textbook p. 141)~~		=A non-journaling popular Linux filesystem -> ext2
	=A journaling popular Linux filesystem -> ext3~~#ext3 is a journaled version of ext2 (Textbook p. 142)~~		=A journaling popular Linux filesystem -> ext3
	=The default Windows 2000 filesystem -> NTFS~~#NTFS is a proprietary Microsoft filesystem~~		=The default Windows 2000 filesystem -> NTFS
	=A widely implemented filesystem used in MS-DOS -> FAT~~#The FAT filesystem is old but used a lot (Textbook p. 143)~~		=A widely implemented filesystem used in MS-DOS -> FAT
	}		}

BenFranske: /* Matching Questions */

2012-02-07T04:28:54Z

Matching Questions

← Older revision		Revision as of 04:28, 7 February 2012
Line 55:		Line 55:

	==Matching Questions==		==Matching Questions==
	With a matching question you are given the first part of a pair and asked to select the second part from a list of possible choices. For formatting purposes it is better if you put longer parts of the matched pair first and shorter parts second. Matching questions can contain any number of matched pairs, but it is generally best to have 4-6 pairs. Note that with a matching question each answer line begins with an equals sign (=) and the two halves of the matching section are linked with an arrow (->) made up of a dash (-) and a greater than sign (>).		With a matching question you are given the first part of a pair and asked to select the second part from a list of possible choices. For formatting and readability purposes it is better if you put longer parts of the matched pair first and shorter parts second. The second part of each answer is what will appear in the dropdown box. Matching questions can contain any number of matched pairs, but it is generally best to have 4-6 pairs. Note that with a matching question each answer line begins with an equals sign (=) and the two halves of the matching section are linked with an arrow (->) made up of a dash (-) and a greater than sign (>). The GIFT format does not allow feedback for matching questions so you do not need to include feedback about why answers are correct or incorrect for this question type.

	Example:		Example:

BenFranske at 22:14, 17 January 2011

2011-01-17T22:14:44Z

← Older revision		Revision as of 22:14, 17 January 2011
Line 5:		Line 5:

	It is not uncommon for questions about computer topics to include some of the special question formatting characters like curly braces, tildes, hashes, equals signs and slashes (forward or backward). If these special characters are part of the question, answer or feedback each one needs to be ''escaped''. To escape a special character you put a single backslash in front of it such as \# which will print just as a # when the question, answer or feedback is displayed.		It is not uncommon for questions about computer topics to include some of the special question formatting characters like curly braces, tildes, hashes, equals signs and slashes (forward or backward). If these special characters are part of the question, answer or feedback each one needs to be ''escaped''. To escape a special character you put a single backslash in front of it such as \# which will print just as a # when the question, answer or feedback is displayed.

			You can work on the questions in any text editor though a plain text editor is best. An example of a plain text editor on Microsoft Windows is the notepad.exe program. When submitting new questions you should simply copy and paste the question text into the body of an email message, be sure not to add any additional formatting.

	=Moodle Question Types=		=Moodle Question Types=

BenFranske at 22:12, 17 January 2011

2011-01-17T22:12:52Z

← Older revision		Revision as of 22:12, 17 January 2011
Line 53:		Line 53:

	==Matching Questions==		==Matching Questions==
	With a matching question you are given the first part of a pair and asked to select the second part from a list of possible choices. For formatting purposes it is better if you put longer parts of the matched pair first and shorter parts second. Matching questions can contain any number of matched pairs, but it is generally best to have 4-6 pairs.		With a matching question you are given the first part of a pair and asked to select the second part from a list of possible choices. For formatting purposes it is better if you put longer parts of the matched pair first and shorter parts second. Matching questions can contain any number of matched pairs, but it is generally best to have 4-6 pairs. Note that with a matching question each answer line begins with an equals sign (=) and the two halves of the matching section are linked with an arrow (->) made up of a dash (-) and a greater than sign (>).

	Example:		Example:
	Match the following filesystems with their features. {		// This question is asking about the filesystems used by various operating systems
	=A non-journaling popular Linux filesystem -> ext2		::Match the following filesystems with their features.::Match the following filesystems with their features. {
	=A journaling popular Linux filesystem -> ext3		=A non-journaling popular Linux filesystem -> ext2#ext2 is the traditional Linux native filesystem (Textbook p. 141)
	=The default Windows 2000 filesystem -> NTFS		=A journaling popular Linux filesystem -> ext3#ext3 is a journaled version of ext2 (Textbook p. 142)
	=A widely ~~implement~~ filesystem used in MS-DOS -> FAT		=The default Windows 2000 filesystem -> NTFS#NTFS is a proprietary Microsoft filesystem
			=A widely implemented filesystem used in MS-DOS -> FAT#The FAT filesystem is old but used a lot (Textbook p. 143)
	}		}

	==True/False Questions==		==True/False Questions==
	True/False questions are easily created but should be used sparingly ~~as they are much easier to guess the answer to~~.		True/False questions are easily created on a single line but should be used sparingly.

	True Statement Example:		True Statement Example:
	Apple sold personal computers before IBM did.{TRUE}		::Apple sold personal computers before IBM did.::Apple sold personal computers before IBM did.{TRUE#The Apple I came before the IBM PC.}

	False Statement Example:		False Statement Example:
	Al Gore invented the Internet.{FALSE}		::Al Gore invented the Internet.::Al Gore invented the Internet.{FALSE#He did assist in providing funding though.}

BenFranske at 21:55, 17 January 2011

2011-01-17T21:55:01Z

← Older revision		Revision as of 21:55, 17 January 2011
Line 1:		Line 1:
	Moodle is the Learning Management System used on the CNT CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format ~~documentationcan~~ be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.		Moodle is the Learning Management System used on the CNT CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentation can be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.

			=General Information=
			There are three main sections to a Moodle question: the question name, the question and the answer section. The answer section should also include feedback about why the answer is correct or incorrect and where the answer can be verified.

			It is not uncommon for questions about computer topics to include some of the special question formatting characters like curly braces, tildes, hashes, equals signs and slashes (forward or backward). If these special characters are part of the question, answer or feedback each one needs to be ''escaped''. To escape a special character you put a single backslash in front of it such as \# which will print just as a # when the question, answer or feedback is displayed.

	=Moodle Question Types=		=Moodle Question Types=
	==Multiple Choice Questions==		==Multiple Choice Questions==
	A basic multiple choice question is easy to write in the GIFT format. Multiple ~~choice~~ questions should usually have four choices, one which is correct and three which are incorrect. The incorrect answers should be believable but definitely wrong.		===Multiple Choice Single Answer===
			A basic multiple choice question, with one correct answer, is easy to write in the GIFT format. This type of question is referred to as a Multiple Choice Single Answer or MCSA question. MCSA questions should usually have four choices, one which is correct and three which are incorrect. The incorrect answers should be believable but definitely wrong.

	A basic ~~multiple choice~~ example:		A basic MCSA example:
	The text of your question goes here? {		// This line is a comment. You can use comments for your own use, they are not required
	=The correct answer		::The name of your question goes here::The text of your question goes here?{
	~An incorrect answer		=The correct answer begins with an equals sign
	~Another incorrect answer		~An incorrect answer begins with a tilde
	~A third incorrect answer		~Another incorrect answer
			~A third incorrect answer
	}		}

	~~How this might look~~ with a ~~real~~ question:		Note that the correct answer begins with an equals sign (=) and incorrect answers begin with tildes (~). All of the answers are indented with a tab.
	What is a layer three network address most commonly called? {
	=An IP Address		When you write an actual question you should provide feedback about why answers are correct or incorrect and where the answer can be verified. Feedback comes after each answer and is separated from the answer by a hash sign (#). The question name should usually be identical to the question text but if the question is long or has special formatting the ''name'' of the question should be a short and simple description of what the question is asking about instead of a complete duplication of the question. Here's an example of a complete MCSA question:
	~A MAC Address		// This question is a basic question about the OSI model, remember this line is just a comment for your own use
	~A NetBIOS Address		::What is a layer three network address most commonly called?::What is a layer three network address most commonly called?{
	~A Sector Address		=An IP Address#IP Addresses are the type of address most commonly used at layer three of the OSI model. (Textbook p. 42)
			~A MAC Address#MAC Addresses are layer two addresses (Textbook p. 42)
			~A NetBIOS Address#NetBIOS addresses are not as common as IP Addresses (Textbook p. 41)
			~A Sector Address#Sector addresses are used for locating data on disks, not for networking.
	}		}

	It is ~~better if you can provide~~ feedback about why answers are correct or ~~incorrect~~ (or at least ~~cite~~ a ~~book page number where~~ the correct answer ~~can~~ be ~~found~~. ~~Here's an example:~~		Remember that the "answers" displayed will just be "An IP Address, A MAC Address, A NetBIOS Address and A Sector Address. The remainder of each line is feedback about why each answer is correct or incorrect and where the answer can be verified. Also remember that it is not uncommon for questions about computer topics to include some of the special question formatting characters like curly braces, tildes, hashes, equals signs and slashes (forward or backward). If these special characters are part of the question, answer or feedback each one needs to be ''escaped''. To escape a special character you put a single backslash in front of it such as \# which will print just as a # when the question, answer or feedback is displayed.
	~~What is~~ a ~~layer three network address most commonly called~~? {
	~~=An~~ IP ~~Address~~#~~According to~~ the ~~OSI model IP Addresses are the type of address most commonly used at layer three.~~ (p. 42)		You should never have answers that refer to the location of other answers (all of the above, choices a, b, and c, etc.). The answers to each question are presented in a random order so it is not possible to know which answers are above the current answer or what letter choice each answer will be. If you have a question like this it is better to create a multiple choice multiple answer (MCMA) question instead.
	~~~A MAC Address~~#~~MAC Addresses are layer two addresses~~ (p. 42)
	~~~A NetBIOS Address~~#~~NetBIOS addresses are~~ not ~~as common as IP Addresses~~ (p. 41)		===Multiple Choice Multiple Answer===
	~~~A Sector Address~~#~~Sector addresses are~~ used for ~~locating data on disks~~, not ~~for networking~~.		A more complex multiple choice question has more than one correct answer. This type of question is referred to as a Multiple Choice Multiple Answer or MCMA question. MCMA questions should have at least four choices. At least one choice should be correct (the choice could be "None of these") and at least one choice is normally incorrect though once in a while it is alright to have all of the answers be correct. Incorrect answers should be believable but definitely wrong.

			The key differences with MCMA questions is that all of the answers begin with a tilde (~). Each answer (correct and incorrect) must be assigned a percentage of the credit for the overall question. The points for all of the correct answers should add up to 100% and these should normally be divided equally among all correct answers. Incorrect answers should be worth -100%.

			// This question asks about Linux tools which can discover open ports on a system
			::Which tools would help discover open ports?::Which tools would help discover open ports?{
			~%-100%DHCP#DHCP provides IP addresses and has nothing to do with open ports (Textbook p. 392)
			~%33.333%netstat#Netstat provides a list of all open ports on the local system (Textbook p. 414)
			~%33.333%nmap#Nmap can be used to find open ports on local and remote systems (Textbook p. 487)
			~%-100%SSH#SSH is used for remote connections to another system, not finding ports (Textbook p. 499)
			~%-100%find#Find is used for finding files, not ports (Textbook p. 212)
			~%33.333%lsof#Lsof can list open ports as well as files (Textbook p. 485)
	}		}

			Note that is this example there are three correct answers so each one is worth 1/3 of 100% which is rounded off to three decimal places 33.333%.

	==Matching Questions==		==Matching Questions==
Line 46:		Line 69:
	Apple sold personal computers before IBM did.{TRUE}		Apple sold personal computers before IBM did.{TRUE}

	False Statement ~~Exmaple~~:		False Statement Example:
	Al Gore invented the Internet.{FALSE}		Al Gore invented the Internet.{FALSE}

BenFranske: Created page with 'Moodle is the Learning Management System used on the CNT CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format …'

2010-08-26T17:03:02Z

Created page with 'Moodle is the Learning Management System used on the CNT CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format …'

New page

Moodle is the Learning Management System used on the CNT CLASS server. If you are asked to write Moodle compatible questions the preferred format for doing so is the GIFT format which can be directly imported by Moodle. The complete GIFT format documentationcan be found on [http://docs.moodle.org/en/GIFT The Moodle GIFT site] but this should give you enough information to get started with the most popular types of questions.

=Moodle Question Types=
==Multiple Choice Questions==
A basic multiple choice question is easy to write in the GIFT format. Multiple choice questions should usually have four choices, one which is correct and three which are incorrect. The incorrect answers should be believable but definitely wrong.

A basic multiple choice example:
The text of your question goes here? {
=The correct answer
~An incorrect answer
~Another incorrect answer
~A third incorrect answer
}

How this might look with a real question:
What is a layer three network address most commonly called? {
=An IP Address
~A MAC Address
~A NetBIOS Address
~A Sector Address
}

It is better if you can provide feedback about why answers are correct or incorrect (or at least cite a book page number where the correct answer can be found. Here's an example:
What is a layer three network address most commonly called? {
=An IP Address#According to the OSI model IP Addresses are the type of address most commonly used at layer three. (p. 42)
~A MAC Address#MAC Addresses are layer two addresses (p. 42)
~A NetBIOS Address#NetBIOS addresses are not as common as IP Addresses (p. 41)
~A Sector Address#Sector addresses are used for locating data on disks, not for networking.
}

==Matching Questions==
With a matching question you are given the first part of a pair and asked to select the second part from a list of possible choices. For formatting purposes it is better if you put longer parts of the matched pair first and shorter parts second. Matching questions can contain any number of matched pairs, but it is generally best to have 4-6 pairs.

Example:
Match the following filesystems with their features. {
=A non-journaling popular Linux filesystem -> ext2
=A journaling popular Linux filesystem -> ext3
=The default Windows 2000 filesystem -> NTFS
=A widely implement filesystem used in MS-DOS -> FAT
}

==True/False Questions==
True/False questions are easily created but should be used sparingly as they are much easier to guess the answer to.

True Statement Example:
Apple sold personal computers before IBM did.{TRUE}

False Statement Exmaple:
Al Gore invented the Internet.{FALSE}