https://microformats.org/wiki/api.php?action=feedcontributions&user=Jsalsman&feedformat=atomMicroformats Wiki - User contributions [en]2024-03-29T07:17:53ZUser contributionsMediaWiki 1.38.4https://microformats.org/wiki/index.php?title=quiz&diff=44107quiz2011-06-18T21:11:41Z<p>Jsalsman: Redirecting to gift</p>
<hr />
<div>#redirect [[gift]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=gift&diff=42760gift2010-07-06T16:34:56Z<p>Jsalsman: /* Notes for further work */ 1972 ERIC PLATO concept and spelling recognition work</p>
<hr />
<div>__TOC__<br />
<br />
<entry-title>GIFT Format</entry-title><br />
;short URL<br />
:http://bit.ly/gift-fmt <!-- (this page) or http://bit.ly/giftex (extension proposals) --><br />
<br />
The [http://docs.moodle.org/en/GIFT_format GIFT picoformat] allows writing multiple-choice, true-false, fill-in-the-blank (also called short answer or missing word), matching, and numerical quiz questions in a simple text format. The GPLed [http://moodle.org/ Moodle] Course/Learning Management System can import and export questions in the GIFT format. The extensions described below should enable easily authorable self-study, learner-adaptive, low-stakes quiz extensions for Wikiversity and other projects.<br />
<br />
=== Syntax ===<br />
<br />
GIFT quiz questions must be encoded in utf-8 characters, and are delimited by blank lines. A question may be preceded by a title inside a pair of double colons and must include or be followed by an answer specification in curly braces. Examples are shown below.<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // text || Comment until end of line (optional)<br />
|-<br />
| ::title:: || Question title (optional)<br />
|-<br />
| text || Question text (becomes title if no title specified)<br />
|-<br />
| { || Start answer(s) -- without any answers, text is a description of following questions<br />
|-<br />
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}<br />
|-<br />
| { ... =right ... } || Correct answer for multiple choice, (multiple answer?) or fill-in-the-blank<br />
|-<br />
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer<br />
|-<br />
| { ... =item -> match ... } || Answer for matching questions<br />
|-<br />
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers<br />
|-<br />
| {# || Start numeric answer(s)<br />
|-<br />
| answer:tolerance || Numeric answer accepted within ± tolerance range<br />
|-<br />
| low..high || Lower and upper range values of accepted numeric answer <br />
|-<br />
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer<br />
|-<br />
| } || End answer(s); additional text may follow for fill-in-the-blank<br />
|-<br />
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :<br />
|-<br />
| \n || Places a newline in question text -- blank lines delimit questions<br />
|}<br />
<br />
==== Examples ====<br />
<br />
// true-false<br />
::Q1:: 1+1=2 {T} // not sure if comments are okay here<br />
<br />
// multiple choice with specific feedback<br />
::Q2:: What's between orange and green in the spectrum?<br />
{=yellow # correct! ~red # wrong, it's yellow ~blue # wrong, it's yellow}<br />
<br />
// fill-in-the-blank<br />
::Q3:: Two plus {=two =2} equals four.<br />
<br />
// matching<br />
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }<br />
<br />
// math range question -- note: {#1..5} is the same range<br />
::Q5:: What is a number from 1 to 5? {#3:2}<br />
<br />
// multiple numeric answers with partial credit and feedback<br />
::Q7:: When was Ulysses S. Grant born? {#<br />
=1822:0 # Correct! You get full credit.<br />
=%50%1822:2 # He was born in 1822. You get half credit for being close.<br />
}<br />
<br />
// essay<br />
::Q8:: How are you? {}<br />
<br />
// alternate layout<br />
::Title <br />
:: Question {<br />
=Correct answer 1<br />
=Correct answer 2<br />
~Wrong answer 1<br />
#Response to wrong answer 1<br />
~Wrong answer 2<br />
#Response to wrong answer 2<br />
}<br />
<br />
:''Note: the table and examples above were adapted from and then migrated back to the GPL-licensed Moodle site, not copied from there.''<br />
<br />
=== Categories ===<br />
<br />
Question categories may be specified by preceding them with <br />
<br />
<code><br />
$CATEGORY: path/name<br />
</code><br />
<br />
with a blank line before and after. That sets the following questions' category name or pathname.<br />
<br />
=== Case insensitive ===<br />
<br />
Alphabetic case-sensitive comparison is off by default, but may be enabled for short answer (fill-in-the-blank) questions that need them (usually a very unlikely occurrence, except, e.g., in some chemical formulae like proteins) with:<br />
<br />
<code><br />
$question->usecase = 1;<br />
</code><br />
<br />
=== Extensions ===<br />
<br />
Please help sponsor these extensions at http://talknicer.com<br />
<br />
==== Learner adaptation ====<br />
<br />
Still to be done to extend the format for [http://en.wikipedia.org/wiki/Computerized_adaptive_testing computerized adaptive testing] (per, for example, del Soldato, T. & du Boulay, B. (1995) "Implementation of Motivational Tactics in Tutoring Systems," ''Journal of Artificial Intelligence in Education,'' '''6'''(4): 337-78) is to add optional prerequisite and relative difficulty links to other questions (titles can be used) and optional question help text at two levels of specificity:<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // helps-answer: title[, title...] || Set of questions which help answer this question<br />
|-<br />
| // helped-by: title[,...] || Set of questions which answering this question helps answer<br />
|-<br />
| // easier-than: title[%n%][,...] <br /> // harder-than: title[%n%][,...] || Sets of relations to other questions by relative difficulty<br />
|-<br />
| // general-help: text || Optional general help<br />
|-<br />
| // specific-help: text || Optional specific help<br />
|-<br />
| \// || Two forward slashes, not a comment<br />
|-<br />
| // review-state: text || Summary of accuracy review status (see below)<br />
|}<br />
<br />
Can some of the directed graph of which questions assist in the answering of other questions be derived from categorization or must it be stored completely explicitly?<br />
<br />
==== Accuracy review ====<br />
<br />
It would also help to be able to specify the state of the question in a [http://strategy.wikimedia.org/wiki/Proposal:Develop_systems_for_accuracy_review review system]:<br />
<br />
* incomplete<br />
** (ungrammatical, ambiguous, non-sequitur, implies false assumption, circular, dependent on future circumstance or decision, etc.)<br />
* open<br />
** hypothetical (also open -- but less so?)<br />
** answered ("proposed"?)<br />
*** reviewed<br />
**** complete (passed review)<br />
***** asked<br />
****** scored<br />
******* challenged<br />
******** assessed<br />
**** rejected (failed review or assessment)<br />
<br />
[http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content (source)]<br />
<br />
==== Examples ====<br />
<br />
Comments with special hyphenated keywords with colons can be used preceding or following the questions as long as blank lines don't intervene. For example:<br />
<br />
// helps-answer: latte-color // helps if you know this to answer that<br />
::milk-color // title; not sure if comment ok here <br />
// easier-than: sky-color, // this question is easier than those two<br />
// shroedinger-eqn%1% // numeric quantity for relative difficulty<br />
:: What color is milk? { // question<br />
=white // answer<br />
}<br />
// general-help: Think about full milk bottles. // general help<br />
// specific-help: It's the same color as chalk. // specific help<br />
// review-state: proposed // summary of review status<br />
<br />
That would apparently cover the stated extension requirements. The reflexive links (helps/helped, easier/harder) can be implicit where they aren't specified. Not sure whether it's a good idea to specify [http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content#assessment_item_fields summary statistics from question fields] as they might exist in a database. Maybe that should be specified but discouraged in practice, because some of the metadata grows every time a question is answered.<br />
<br />
==== Include ====<br />
<br />
Some way to include GIFT files at other locations would be nice. Perhaps: <tt>// include:</tt> (filename|url|wikipage)<br />
<br />
=== Notes for further work ===<br />
<br />
The score-based computer adaptive testing process already implemented in Moodle may be much simpler and easier to re-implement than del Soldato and du Boulay's 1995 [[gift-syntax/dsd-tutor-rules|rules]] -- which require assessment of confidence (self-reported), effort (logging), and independence (frequency of help requests) instead of just scoring questions -- and [[gift-syntax/dsd-tutor-schema|this schema]] based on those rules and the ''Journal of Artificial Intelligence in Education'' article they appeared in. But the primary goals listed here are likely satisfied with the detail shown above.<br />
<br />
The [http://en.wikipedia.org/wiki/TUTOR_%28programming_language%29#Answer_judging "answer judging" of the 1970s-era PLATO TUTOR language] is appropriate for fill-in-the-blank pattern matching. (See also Tenczar, P.J. and Golden, W.M. (1972) [http://www.eric.ed.gov/PDFS/ED124944.pdf "Spelling, Word, and Concept Recognition",] CERL Report X-35 (Urbana, Illinois: Computer-based Education Research Lab, U of IL) ''Plato Publications''.)<br />
<br />
There is more we may want to accomplish noted in the [http://en.wikipedia.org/wiki/Spacing_effect "Spacing effect"] Wikipedia article and [http://en.wikipedia.org/wiki/Bloom%27s_Taxonomy#Cognitive "Bloom's cognitive taxonomy,"] suggesting sub-categories.<br />
<br />
<!-- ; Please disregard posting character counts here<br />
<br />
I asked for a count of the characters @, !, $, *, ;, and _ in {answer specifications} at http://moodle.org/mod/forum/discuss.php?d=143213 -- if you are responding, please never mind. Thanks anyway! [[User:JSalsman|JSalsman]] 22:27, 10 February 2010 (UTC) <br />
--><br />
<br />
===See also===<br />
<br />
*http://www.mediawiki.org/wiki/Extension:Quiz<br />
**[http://www.mediawiki.org/wiki/Extension_talk:Quiz#GIFT_format_and_Quiz_tables.3F Mediawiki Quiz extension talk: GIFT format and Quiz tables?]<br />
**[https://bugzilla.wikimedia.org/show_bug.cgi?id=22475 Mediawiki bug (enhancement request) 22475]<br />
*[http://strategy.wikimedia.org/wiki/Proposal:Assessment_content Wikimedia assessment content proposal]<br />
**http://en.wikiversity.org/wiki/Help:Quiz<br />
**[http://en.wikiversity.org/wiki/Help:Quiz/Wikiversity_compared_to_Moodle Wikiversity compared to Moodle]<br />
**http://en.wikiversity.org/wiki/Category:Quizzes<br />
<br />
*[http://buypct.com/gift_reference.pdf 5-page reference] (PDF)<br />
<br />
*[[picoformats]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=gift&diff=42651gift2010-06-07T04:53:04Z<p>Jsalsman: http://en.wikipedia.org/wiki/TUTOR_%28programming_language%29#Answer_judging</p>
<hr />
<div>__TOC__<br />
<br />
<entry-title>GIFT Format</entry-title><br />
;short URL<br />
:http://bit.ly/gift-fmt <!-- (this page) or http://bit.ly/giftex (extension proposals) --><br />
<br />
The [http://docs.moodle.org/en/GIFT_format GIFT picoformat] allows writing multiple-choice, true-false, fill-in-the-blank (also called short answer or missing word), matching, and numerical quiz questions in a simple text format. The GPLed [http://moodle.org/ Moodle] Course/Learning Management System can import and export questions in the GIFT format. The extensions described below should enable easily authorable self-study, learner-adaptive, low-stakes quiz extensions for Wikiversity and other projects.<br />
<br />
=== Syntax ===<br />
<br />
GIFT quiz questions must be encoded in utf-8 characters, and are delimited by blank lines. A question may be preceded by a title inside a pair of double colons and must include or be followed by an answer specification in curly braces. Examples are shown below.<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // text || Comment until end of line (optional)<br />
|-<br />
| ::title:: || Question title (optional)<br />
|-<br />
| text || Question text (becomes title if no title specified)<br />
|-<br />
| { || Start answer(s) -- without any answers, text is a description of following questions<br />
|-<br />
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}<br />
|-<br />
| { ... =right ... } || Correct answer for multiple choice, (multiple answer?) or fill-in-the-blank<br />
|-<br />
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer<br />
|-<br />
| { ... =item -> match ... } || Answer for matching questions<br />
|-<br />
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers<br />
|-<br />
| {# || Start numeric answer(s)<br />
|-<br />
| answer:tolerance || Numeric answer accepted within ± tolerance range<br />
|-<br />
| low..high || Lower and upper range values of accepted numeric answer <br />
|-<br />
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer<br />
|-<br />
| } || End answer(s); additional text may follow for fill-in-the-blank<br />
|-<br />
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :<br />
|-<br />
| \n || Places a newline in question text -- blank lines delimit questions<br />
|}<br />
<br />
==== Examples ====<br />
<br />
// true-false<br />
::Q1:: 1+1=2 {T} // not sure if comments are okay here<br />
<br />
// multiple choice with specific feedback<br />
::Q2:: What's between orange and green in the spectrum?<br />
{=yellow # correct! ~red # wrong, it's yellow ~blue # wrong, it's yellow}<br />
<br />
// fill-in-the-blank<br />
::Q3:: Two plus {=two =2} equals four.<br />
<br />
// matching<br />
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }<br />
<br />
// math range question -- note: {#1..5} is the same range<br />
::Q5:: What is a number from 1 to 5? {#3:2}<br />
<br />
// multiple numeric answers with partial credit and feedback<br />
::Q7:: When was Ulysses S. Grant born? {#<br />
=1822:0 # Correct! You get full credit.<br />
=%50%1822:2 # He was born in 1822. You get half credit for being close.<br />
}<br />
<br />
// essay<br />
::Q8:: How are you? {}<br />
<br />
// alternate layout<br />
::Title <br />
:: Question {<br />
=Correct answer 1<br />
=Correct answer 2<br />
~Wrong answer 1<br />
#Response to wrong answer 1<br />
~Wrong answer 2<br />
#Response to wrong answer 2<br />
}<br />
<br />
:''Note: the table and examples above were adapted from and then migrated back to the GPL-licensed Moodle site, not copied from there.''<br />
<br />
=== Categories ===<br />
<br />
Question categories may be specified by preceding them with <br />
<br />
<code><br />
$CATEGORY: path/name<br />
</code><br />
<br />
with a blank line before and after. That sets the following questions' category name or pathname.<br />
<br />
=== Case insensitive ===<br />
<br />
Alphabetic case-sensitive comparison is off by default, but may be enabled for short answer (fill-in-the-blank) questions that need them (usually a very unlikely occurrence, except, e.g., in some chemical formulae like proteins) with:<br />
<br />
<code><br />
$question->usecase = 1;<br />
</code><br />
<br />
=== Extensions ===<br />
<br />
Please help sponsor these extensions at http://talknicer.com<br />
<br />
==== Learner adaptation ====<br />
<br />
Still to be done to extend the format for [http://en.wikipedia.org/wiki/Computerized_adaptive_testing computerized adaptive testing] (per, for example, del Soldato, T. & du Boulay, B. (1995) "Implementation of Motivational Tactics in Tutoring Systems," ''Journal of Artificial Intelligence in Education,'' '''6'''(4): 337-78) is to add optional prerequisite and relative difficulty links to other questions (titles can be used) and optional question help text at two levels of specificity:<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // helps-answer: title[, title...] || Set of questions which help answer this question<br />
|-<br />
| // helped-by: title[,...] || Set of questions which answering this question helps answer<br />
|-<br />
| // easier-than: title[%n%][,...] <br /> // harder-than: title[%n%][,...] || Sets of relations to other questions by relative difficulty<br />
|-<br />
| // general-help: text || Optional general help<br />
|-<br />
| // specific-help: text || Optional specific help<br />
|-<br />
| \// || Two forward slashes, not a comment<br />
|-<br />
| // review-state: text || Summary of accuracy review status (see below)<br />
|}<br />
<br />
Can some of the directed graph of which questions assist in the answering of other questions be derived from categorization or must it be stored completely explicitly?<br />
<br />
==== Accuracy review ====<br />
<br />
It would also help to be able to specify the state of the question in a [http://strategy.wikimedia.org/wiki/Proposal:Develop_systems_for_accuracy_review review system]:<br />
<br />
* incomplete<br />
** (ungrammatical, ambiguous, non-sequitur, implies false assumption, circular, dependent on future circumstance or decision, etc.)<br />
* open<br />
** hypothetical (also open -- but less so?)<br />
** answered ("proposed"?)<br />
*** reviewed<br />
**** complete (passed review)<br />
***** asked<br />
****** scored<br />
******* challenged<br />
******** assessed<br />
**** rejected (failed review or assessment)<br />
<br />
[http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content (source)]<br />
<br />
==== Examples ====<br />
<br />
Comments with special hyphenated keywords with colons can be used preceding or following the questions as long as blank lines don't intervene. For example:<br />
<br />
// helps-answer: latte-color // helps if you know this to answer that<br />
::milk-color // title; not sure if comment ok here <br />
// easier-than: sky-color, // this question is easier than those two<br />
// shroedinger-eqn%1% // numeric quantity for relative difficulty<br />
:: What color is milk? { // question<br />
=white // answer<br />
}<br />
// general-help: Think about full milk bottles. // general help<br />
// specific-help: It's the same color as chalk. // specific help<br />
// review-state: proposed // summary of review status<br />
<br />
That would apparently cover the stated extension requirements. The reflexive links (helps/helped, easier/harder) can be implicit where they aren't specified. Not sure whether it's a good idea to specify [http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content#assessment_item_fields summary statistics from question fields] as they might exist in a database. Maybe that should be specified but discouraged in practice, because some of the metadata grows every time a question is answered.<br />
<br />
==== Include ====<br />
<br />
Some way to include GIFT files at other locations would be nice. Perhaps: <tt>// include:</tt> (filename|url|wikipage)<br />
<br />
=== Notes for further work ===<br />
<br />
The score-based computer adaptive testing process already implemented in Moodle may be much simpler and easier to re-implement than del Soldato and du Boulay's 1995 [[gift-syntax/dsd-tutor-rules|rules]] -- which require assessment of confidence (self-reported), effort (logging), and independence (frequency of help requests) instead of just scoring questions -- and [[gift-syntax/dsd-tutor-schema|this schema]] based on those rules and the ''Journal of Artificial Intelligence in Education'' article they appeared in. But the primary goals listed here are likely satisfied with the detail shown above.<br />
<br />
The [http://en.wikipedia.org/wiki/TUTOR_%28programming_language%29#Answer_judging "answer judging" of the 1970s-era PLATO TUTOR language] is appropriate for fill-in-the-blank pattern matching.<br />
<br />
There is more we may want to accomplish noted in the [http://en.wikipedia.org/wiki/Spacing_effect "Spacing effect"] Wikipedia article and [http://en.wikipedia.org/wiki/Bloom%27s_Taxonomy#Cognitive "Bloom's cognitive taxonomy,"] suggesting sub-categories.<br />
<br />
<!-- ; Please disregard posting character counts here<br />
<br />
I asked for a count of the characters @, !, $, *, ;, and _ in {answer specifications} at http://moodle.org/mod/forum/discuss.php?d=143213 -- if you are responding, please never mind. Thanks anyway! [[User:JSalsman|JSalsman]] 22:27, 10 February 2010 (UTC) <br />
--><br />
===See also===<br />
<br />
*http://www.mediawiki.org/wiki/Extension:Quiz<br />
**[http://www.mediawiki.org/wiki/Extension_talk:Quiz#GIFT_format_and_Quiz_tables.3F Mediawiki Quiz extension talk: GIFT format and Quiz tables?]<br />
**[https://bugzilla.wikimedia.org/show_bug.cgi?id=22475 Mediawiki bug (enhancement request) 22475]<br />
*[http://strategy.wikimedia.org/wiki/Proposal:Assessment_content Wikimedia assessment content proposal]<br />
**http://en.wikiversity.org/wiki/Help:Quiz<br />
**[http://en.wikiversity.org/wiki/Help:Quiz/Wikiversity_compared_to_Moodle Wikiversity compared to Moodle]<br />
**http://en.wikiversity.org/wiki/Category:Quizzes<br />
<br />
*[http://buypct.com/gift_reference.pdf 5-page reference] (PDF)<br />
<br />
*[[picoformats]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=wiki-better-than-email&diff=42281wiki-better-than-email2010-04-03T18:58:02Z<p>Jsalsman: /* reasons */ not everyone knows s/n</p>
<hr />
<div><entry-title>Wiki is better than email</entry-title> <br />
<br />
The wiki works better than email for content (examples, issues, brainstorms etc.) for numerous reasons. <br />
<br />
;short URL<br />
:http://tr.im/wikibetter<br />
<br />
== wikis in plain english ==<br />
Here is a short video explaining how wikis work much better than email for collaboration, even for something as simple as planning a camping trip.<br />
<br />
[http://www.youtube.com/watch?v=-dnL00TdmLY http://i2.ytimg.com/vi/-dnL00TdmLY/default.jpg][http://www.youtube.com/watch?v=-dnL00TdmLY YouTube: Wikis in Plain English]<br />
<br />
== reasons ==<br />
Here are some reasons why wikis work better than email for microformats in particular, and in fact, for any kind of open standards development.<br />
<br />
* <span id="scaling">'''signal-to-noise scaling.'''</span> Not everyone is interested in every issue on every format.<br />
* <span id="efficiency">'''efficiency: reading current state vs deltas.'''</span> You can read one wiki page to get the status/thread of an issue whereas with emails you often have to read thru numerous emails (and threads) and apply them like deltas/diffs in your head to understand where an issue etc. ended up.<br />
* <span id="search">'''search/discoverability.'''</span> search for the web/wikis works much better in practice than searching mailing lists (web search of email archives has no thread-smarts for example).<br />
* <span id="pd">'''public domain.'''</span> Wiki contributions are required public domain, while in email there is no UI to enforce this, thus email should be use only "informatively" for notifications and never for capturing material of any substance.<br />
* <span id="tradition">'''tradition.'''</span> microformats have been documented on a wiki since their inception, as a result the wiki is the definitive resource for all matters microformats; not any of the mailing lists. The community has had a longstanding tradition preferring use of the wiki for content over email. We realize this is fairly novel for a standards community, as most standards communities are email-centric (e.g. W3C, IETF). However, for all the above reasons we believe using wikis for content is far superior to email and thus hope that other standards communities shift more of their activities to being web/wiki-based rather than email lists.<br />
<br />
<div class="discussion"><br />
* historical note: microformats have always been developed via public IRC + wiki since 2004 when Kevin Marks and Tantek Çelik first started researching/brainstorming/drafting microformats such as [[rel-license]], [[vote-links]], [[XOXO]], [[hCard]], [[hCalendar]] on the public Technorati Developer's Wiki and the Freenode IRC network. Brian Suda somehow discovered the Technorati Developer's wiki page for hCard, started editing it, and that's how he and Tantek Çelik met. The [[mailing-lists]] were not created until the microformats.org site was launched in mid 2005 and have always been considered secondary to the wiki and IRC channel.<br />
** exception: hAudio was developed almost entirely through e-mail and wiki edits. -- [[User:ManuSporny|ManuSporny]] 03:37, 28 February 2009 (UTC)<br />
*** In retrospect, allowing that was probably a mistake, as there were far too many emails on the subject of hAudio for I and many others to keep up with, and many issues were resolved with little breadth of discussion (only 1-2 participants, typically Manu and Martin). In the future as a community we should insist that all issues be captured on the wiki, and that all opinions on specific issues be captured on the wiki, so that this information is not lost in email.[[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
</div><br />
<br />
== additional documentation ==<br />
* See the book http://www.wikinomics.com/ for more details and explanations on how wikis are more efficient than email for a variety of workflows.<br />
* This picture helps illustrate one of many scenarios - and though we are not sending word documents, the point is, that iterating content through email is far less efficient than iterating content on a wiki: <br /> [http://www.wikinomics.com/blog/index.php/2008/03/26/wiki-collaboration-leads-to-happiness/ http://www.wikinomics.com/blog/uploads/wiki_collaboration2.jpg]<br />
<br />
== FAQ ==<br />
=== what is the best way to capture and resolve issues ===<br />
''What is the best way to capture and resolve issues through broad consensus?''<br />
<br />
# First check the relevant *-issues page, and if available, the corresponding *-issues-resolved page.<br />
# [[IRC]] can be useful for quickly discovering whether something is an issue or not.<br />
# If you cannot find the answer to an issue by searching, and asking in IRC, then ask a short message on the microformats-discuss list, and mention specifically the relevant *-issues wiki page where you didn't find the issue.<br />
# If it appears you have a new issue, capture it on the appropriate *-issues page.<br />
# If you have an opinion about an existing issue, add a nested list item to the existing issue and a "+1" or "0" or "-1" signifying your approval/ambivalence/disapproval, sign your name with <nowiki>~~~~</nowiki>, and optionally provide reasons for your opinion.<br />
<br />
The wiki, being on the Web and much more easily discoverable, reaches far more people than any email list or the IRC channel. Wiki pages are also much more readable as a summary of opinions, than having to wade through email threads trying to determine who is for/neutral/against any particular issue.<br />
<br />
<div class="discussion"><br />
* Thus the wiki is the best choice for documenting a range of opinions, and archiving discussions that lead to consensus.<br />
** -1 I'm not arguing for an all-or-nothing approach. I think we should discuss on IRC/e-mail, form a consensus of some kind, and then record that consensus on the wiki. The community should allow people to use whatever method works for them, rather than forcing a method of communication and issue resolution onto the community. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)<br />
*** This reasoning is flawed for multiple reasons: [[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
**** '''Different opinions should be captured on the wiki, not just consensus.''' If you only capture consensus, then others with different opinions that come along later will simply restate those different opinions and then the community will waste time arguing the same arguments again. IRC/Email is insufficient for discussion.<br />
**** '''Consensus should arise from expression of opinions on the wiki via +1/0/-1 subpoints.''' If you only capture +1/0/-1 opinions in email, those discussions are inevitably lost in email archives, difficult to find, and difficult to show that consensus actually occured.<br />
**** '''People can communicate informally using whatever method works for them.''' Formal issue capturing/discussion/resolution takes place on the wiki.<br />
**** '''In order to actually keep a community a ''community'', we have to converge on certain methods and practices.''' Issue capturing, discussion, and resolution is one such practice.<br />
</div><br />
<br />
=== what if I cannot find issues on the wiki ===<br />
''What should I do if I cannot find issues on the wiki?''<br />
<br />
''I find it difficult to understand the arguments behind a large number of the items on the Microformats wiki.'' -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
* If a simple search of the wiki fails to quickly reveal an answer to an issue, then ask in the [[IRC]] channel or on an email list as noted in the previous FAQ. <br />
* Responses to such queries should include URLs to answers on the wiki, hopefully with improved discoverability to increase findability of similar issues in the future.<br />
<br />
=== why is IRC better than email ===<br />
''Why is IRC okay, but e-mail not okay? [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
# People can easily choose to be on IRC or not when it is convenient for them to participate in discussions or not and that aspect of easy in/out control is very important. Email on the other hand, is much more cumbersome to subscribe/unsubscribe when you have time to handle discussions or don't. <br />
# In IRC, if a participant has a misconception, others in the channel can quickly correct that participant, rather than the participant waste a lot of time with writing something up that is based on that misconception. In email OTOH, a mistaken assumption in the start of an email can lead to the author wasting time writing paragraphs upon paragraphs dependent on that bad assumption.<br />
<br />
=== what if I do not have time to be on IRC ===<br />
''What if I don't have time to be on IRC?''<br />
<br />
''I do not have the time to sit around in an IRC channel. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
''I need an asynchronous method of communication and IRC doesn't work for me. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
* If you do not have time to be on IRC or want an asynchronous method of communication, you may check the [[IRC]] archives at your convenience.<br />
<br />
=== what if I prefer to do my communication in batches ===<br />
''What if I prefer to do my communication in batches?''<br />
<br />
''I do my communication in batches because that is most efficient for me. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
* If you prefer to do your communication in batches, simply check the [[IRC]] archives, write up simple short follow-ups with references to specific IRC archive permalinks, and paste them into IRC at your convenience.<br />
<br />
=== how do I make sure I do not miss something in IRC ===<br />
''How do I make sure that I don't miss something in IRC?''<br />
<br />
''I can shut off my e-mail client and not worry that I've missed something, I can't necessarily do the same with IRC. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
* You can check the [[IRC]] archives, since the last time you checked the IRC archives, and thus make sure that you don't miss anything without having to be on IRC at all times.<br />
<br />
=== what if someone starts an edit war on an issue ===<br />
''What if someone starts an edit war on an issue?''<br />
<br />
''Edit wars lead to subsequent banning of individuals, as this community has experienced. -- [[User:ManuSporny|ManuSporny]] 03:22, 28 February 2009 (UTC)''<br />
<br />
If someone:<br />
* does a revert without any explanation or follow-up explanatory edit, or<br />
* undoes a revert without any follow-up to an explanation, or<br />
* simply repeats an edit, ignoring previous edit explanations<br />
<br />
Please contact one or more of the [[admins]] either on IRC (preferably) or via email, alerting them and providing URL(s) to the problematic edits on the wiki.<br />
<br />
The admins will follow-up by correcting the wiki.<br />
<br />
Such behavior that is disruptive to the community will not be tolerated.<br />
<br />
If the individual persists in an edit war, especially after one of the admins have stepped in, the admins will warn and then ban the individual for progressively longer ban times as necessary.<br />
<br />
=== how is the wiki better for controversial issues ===<br />
''How is the wiki better for controversial issues?''<br />
<br />
* All issues, whether controversial or not, are better captured on a wiki for future documentation, with permalinks to reduce the probability that the same issue is re-raised (since the previous issue and resolution can be easily referenced by permalink, and often better discovered by search.)<br />
<br />
* If it seems like differences of opinion on an issue are unresolvable, then a wiki can serve to summarize opinions one way or the other (via +1 / -1 / 0 {username} surveys) so that at least the controversy can be recorded rather than incessant "email-ping-pong" where emails simply just go back and forth and no progress is made.<br />
<br />
* In comparison, e-mail does not allow for broad consensus, only the illusion thereof. The problem is that the overwhelming amount of email noise (on issues or formats they may not be interested in) typically results in people simply paying less attention and eventually leaving the mailing lists. [[logical-flaws#Absence_of_objections_is_not_approval|Absence of response is not an indicator of agreement]] or certainly not consensus. Much better to capture the actual issues/responses/opinions on the wiki and not flood the mailing lists.<br />
<br />
=== how is the microformats community different from previous standards communities ===<br />
<br />
''How is the microformats community different from previous standards communities?''<br />
<br />
* The microformats community started with the wiki as central practice, and other methods (including IRC) as merely notification or for very brief discussions that if meaningful were captured on the wiki. <br />
* In comparison the email-centric discussions in other standards communities (e.g. W3C, IETF) has long been overwhelmed by trolls and other bad actors (e.g. www-style and www-html mailing lists) thus significantly reducing both the utility of such lists, and the desire for people of any level of expertise to actually attempt to participate.<br />
<br />
As [http://www.paulgraham.com/trolls.html Paul Graham wrote]:<br />
<blockquote><p>There's a sort of Gresham's Law of trolls: trolls are willing to use a forum with a lot of thoughtful people in it, but thoughtful people aren't willing to use a forum with a lot of trolls in it. Which means that once trolling takes hold, it tends to become the dominant culture.</p></blockquote><br />
<br />
<br />
=== how can the wiki improve objectivity and friendliness ===<br />
''How can the wiki improve objectivity and friendliness?'''<br />
<br />
<div class="discussion"><br />
* The wiki is a vital documentation tool, and we should strive that it be written as a quality piece of documentation of issues and specs. --[[User:BenWard|BenWard]] 23:32, 28 February 2009 (UTC)<br />
** +1 [[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
* In forcing discussion into this format, discussion is blunted, becomes harsh and naturally gravitates toward polarized discussion. This is important for documenting the issue; to distill issues to their core, but this is bad for building friendly, amicable relationships between people trying to work together on microformats. --[[User:BenWard|BenWard]] 23:32, 28 February 2009 (UTC)<br />
** We should encourage neutral/objective documentation of issues, and editing of issues to remove emotional content that could be interpreted as hostile or unfriendly. [[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
** In addition, as [[admins]] we should act quickly to warn and ban individuals who are abusive on the wiki (see above about edit wars). [[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
** On the side of friendliness, we should reach out to and contact new editors over IRC and email as necessary to help familiarize them with [[how-to-play]] and the [[mailing-list]] guidelines. [[User:Tantek|Tantek]] 21:23, 15 June 2009 (UTC)<br />
</div><br />
<br />
== related ==<br />
* [[mailing-lists]]<br />
* [[how-to-play]]<br />
* [[put-it-on-the-wiki]]<br />
== see also ==<br />
* [http://pbworks.com/team-collaboration 7 Deadly Sins That Block Team Collaboration (And How To Overcome Them)]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=User_talk:JSalsman&diff=42278User talk:JSalsman2010-04-02T19:21:26Z<p>Jsalsman: Redirecting to User talk:Jsalsman</p>
<hr />
<div>#redirect [[User talk:Jsalsman]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=User_talk:Jsalsman&diff=42277User talk:Jsalsman2010-04-02T19:21:04Z<p>Jsalsman: Redirecting to User talk:JSalsman</p>
<hr />
<div>#redirect [[User talk:JSalsman]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=User:Jsalsman&diff=42276User:Jsalsman2010-04-02T19:06:48Z<p>Jsalsman: forgot my password sorry</p>
<hr />
<div>#redirect [[User:JSalsman]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=User:Jsalsman&diff=42275User:Jsalsman2010-04-02T19:06:30Z<p>Jsalsman: forgot my password sorry</p>
<hr />
<div>#redirect [[JSalsman]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=gift&diff=42274gift2010-04-02T17:58:24Z<p>Jsalsman: /* Include */ space</p>
<hr />
<div>__TOC__<br />
<br />
<entry-title>GIFT Format</entry-title><br />
;short URL<br />
:http://bit.ly/gift-fmt <!-- (this page) or http://bit.ly/giftex (extension proposals) --><br />
<br />
The [http://docs.moodle.org/en/GIFT_format GIFT picoformat] allows writing multiple-choice, true-false, fill-in-the-blank (also called short answer or missing word), matching, and numerical quiz questions in a simple text format. The GPLed [http://moodle.org/ Moodle] Course/Learning Management System can import and export questions in the GIFT format. The extensions described below should enable easily authorable self-study, learner-adaptive, low-stakes quiz extensions for Wikiversity and other projects.<br />
<br />
=== Syntax ===<br />
<br />
GIFT quiz questions must be encoded in utf-8 characters, and are delimited by blank lines. A question may be preceded by a title inside a pair of double colons and must include or be followed by an answer specification in curly braces. Examples are shown below.<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // text || Comment until end of line (optional)<br />
|-<br />
| ::title:: || Question title (optional)<br />
|-<br />
| text || Question text (becomes title if no title specified)<br />
|-<br />
| { || Start answer(s) -- without any answers, text is a description of following questions<br />
|-<br />
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}<br />
|-<br />
| { ... =right ... } || Correct answer for multiple choice, (multiple answer?) or fill-in-the-blank<br />
|-<br />
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer<br />
|-<br />
| { ... =item -> match ... } || Answer for matching questions<br />
|-<br />
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers<br />
|-<br />
| {# || Start numeric answer(s)<br />
|-<br />
| answer:tolerance || Numeric answer accepted within ± tolerance range<br />
|-<br />
| low..high || Lower and upper range values of accepted numeric answer <br />
|-<br />
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer<br />
|-<br />
| } || End answer(s); additional text may follow for fill-in-the-blank<br />
|-<br />
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :<br />
|-<br />
| \n || Places a newline in question text -- blank lines delimit questions<br />
|}<br />
<br />
==== Examples ====<br />
<br />
// true-false<br />
::Q1:: 1+1=2 {T} // not sure if comments are okay here<br />
<br />
// multiple choice with specific feedback<br />
::Q2:: What's between orange and green in the spectrum?<br />
{=yellow # correct! ~red # wrong, it's yellow ~blue # wrong, it's yellow}<br />
<br />
// fill-in-the-blank<br />
::Q3:: Two plus {=two =2} equals four.<br />
<br />
// matching<br />
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }<br />
<br />
// math range question -- note: {#1..5} is the same range<br />
::Q5:: What is a number from 1 to 5? {#3:2}<br />
<br />
// multiple numeric answers with partial credit and feedback<br />
::Q7:: When was Ulysses S. Grant born? {#<br />
=1822:0 # Correct! You get full credit.<br />
=%50%1822:2 # He was born in 1822. You get half credit for being close.<br />
}<br />
<br />
// essay<br />
::Q8:: How are you? {}<br />
<br />
// alternate layout<br />
::Title <br />
:: Question {<br />
=Correct answer 1<br />
=Correct answer 2<br />
~Wrong answer 1<br />
#Response to wrong answer 1<br />
~Wrong answer 2<br />
#Response to wrong answer 2<br />
}<br />
<br />
:''Note: the table and examples above were adapted from and then migrated back to the GPL-licensed Moodle site, not copied from there.''<br />
<br />
=== Categories ===<br />
<br />
Question categories may be specified by preceding them with <br />
<br />
<code><br />
$CATEGORY: path/name<br />
</code><br />
<br />
with a blank line before and after. That sets the following questions' category name or pathname.<br />
<br />
=== Case insensitive ===<br />
<br />
Alphabetic case-sensitive comparison is off by default, but may be enabled for short answer (fill-in-the-blank) questions that need them (usually a very unlikely occurrence, except, e.g., in some chemical formulae like proteins) with:<br />
<br />
<code><br />
$question->usecase = 1;<br />
</code><br />
<br />
=== Extensions ===<br />
<br />
Please help sponsor these extensions at http://talknicer.com<br />
<br />
==== Learner adaptation ====<br />
<br />
Still to be done to extend the format for [http://en.wikipedia.org/wiki/Computerized_adaptive_testing computerized adaptive testing] (per, for example, del Soldato, T. & du Boulay, B. (1995) "Implementation of Motivational Tactics in Tutoring Systems," ''Journal of Artificial Intelligence in Education,'' '''6'''(4): 337-78) is to add optional prerequisite and relative difficulty links to other questions (titles can be used) and optional question help text at two levels of specificity:<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // helps-answer: title[, title...] || Set of questions which help answer this question<br />
|-<br />
| // helped-by: title[,...] || Set of questions which answering this question helps answer<br />
|-<br />
| // easier-than: title[%n%][,...] <br /> // harder-than: title[%n%][,...] || Sets of relations to other questions by relative difficulty<br />
|-<br />
| // general-help: text || Optional general help<br />
|-<br />
| // specific-help: text || Optional specific help<br />
|-<br />
| \// || Two forward slashes, not a comment<br />
|-<br />
| // review-state: text || Summary of accuracy review status (see below)<br />
|}<br />
<br />
Can some of the directed graph of which questions assist in the answering of other questions be derived from categorization or must it be stored completely explicitly?<br />
<br />
==== Accuracy review ====<br />
<br />
It would also help to be able to specify the state of the question in a [http://strategy.wikimedia.org/wiki/Proposal:Develop_systems_for_accuracy_review review system]:<br />
<br />
* incomplete<br />
** (ungrammatical, ambiguous, non-sequitur, implies false assumption, circular, dependent on future circumstance or decision, etc.)<br />
* open<br />
** hypothetical (also open -- but less so?)<br />
** answered ("proposed"?)<br />
*** reviewed<br />
**** complete (passed review)<br />
***** asked<br />
****** scored<br />
******* challenged<br />
******** assessed<br />
**** rejected (failed review or assessment)<br />
<br />
[http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content (source)]<br />
<br />
==== Examples ====<br />
<br />
Comments with special hyphenated keywords with colons can be used preceding or following the questions as long as blank lines don't intervene. For example:<br />
<br />
// helps-answer: latte-color // helps if you know this to answer that<br />
::milk-color // title; not sure if comment ok here <br />
// easier-than: sky-color, // this question is easier than those two<br />
// shroedinger-eqn%1% // numeric quantity for relative difficulty<br />
:: What color is milk? { // question<br />
=white // answer<br />
}<br />
// general-help: Think about full milk bottles. // general help<br />
// specific-help: It's the same color as chalk. // specific help<br />
// review-state: proposed // summary of review status<br />
<br />
That would apparently cover the stated extension requirements. The reflexive links (helps/helped, easier/harder) can be implicit where they aren't specified. Not sure whether it's a good idea to specify [http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content#assessment_item_fields summary statistics from question fields] as they might exist in a database. Maybe that should be specified but discouraged in practice, because some of the metadata grows every time a question is answered.<br />
<br />
==== Include ====<br />
<br />
Some way to include GIFT files at other locations would be nice. Perhaps: <tt>// include:</tt> (filename|url|wikipage)<br />
<br />
=== Notes for further work ===<br />
<br />
The score-based computer adaptive testing process already implemented in Moodle may be much simpler and easier to re-implement than del Soldato and du Boulay's 1995 [[gift-syntax/dsd-tutor-rules|rules]] -- which require assessment of confidence (self-reported), effort (logging), and independence (frequency of help requests) instead of just scoring questions -- and [[gift-syntax/dsd-tutor-schema|this schema]] based on those rules and the ''Journal of Artificial Intelligence in Education'' article they appeared in. But the primary goals listed here are likely satisfied with the detail shown above.<br />
<br />
There is more we may want to accomplish noted in the [http://en.wikipedia.org/wiki/Spacing_effect "Spacing effect"] Wikipedia article and [http://en.wikipedia.org/wiki/Bloom%27s_Taxonomy#Cognitive "Bloom's cognitive taxonomy,"] suggesting sub-categories.<br />
<br />
; Please disregard posting character counts here<br />
<br />
I asked for a count of the characters @, !, $, *, ;, and _ in {answer specifications} at http://moodle.org/mod/forum/discuss.php?d=143213 -- if you are responding, please never mind. Thanks anyway! [[User:JSalsman|JSalsman]] 22:27, 10 February 2010 (UTC)<br />
<br />
===See also===<br />
<br />
*http://www.mediawiki.org/wiki/Extension:Quiz<br />
**[http://www.mediawiki.org/wiki/Extension_talk:Quiz#GIFT_format_and_Quiz_tables.3F Mediawiki Quiz extension talk: GIFT format and Quiz tables?]<br />
**[https://bugzilla.wikimedia.org/show_bug.cgi?id=22475 Mediawiki bug (enhancement request) 22475]<br />
*[http://strategy.wikimedia.org/wiki/Proposal:Assessment_content Wikimedia assessment content proposal]<br />
**http://en.wikiversity.org/wiki/Help:Quiz<br />
**[http://en.wikiversity.org/wiki/Help:Quiz/Wikiversity_compared_to_Moodle Wikiversity compared to Moodle]<br />
**http://en.wikiversity.org/wiki/Category:Quizzes<br />
<br />
*[http://buypct.com/gift_reference.pdf 5-page reference] (PDF)<br />
<br />
*[[picoformats]]</div>Jsalsmanhttps://microformats.org/wiki/index.php?title=gift&diff=42273gift2010-04-02T17:57:23Z<p>Jsalsman: /* Extensions */ include</p>
<hr />
<div>__TOC__<br />
<br />
<entry-title>GIFT Format</entry-title><br />
;short URL<br />
:http://bit.ly/gift-fmt <!-- (this page) or http://bit.ly/giftex (extension proposals) --><br />
<br />
The [http://docs.moodle.org/en/GIFT_format GIFT picoformat] allows writing multiple-choice, true-false, fill-in-the-blank (also called short answer or missing word), matching, and numerical quiz questions in a simple text format. The GPLed [http://moodle.org/ Moodle] Course/Learning Management System can import and export questions in the GIFT format. The extensions described below should enable easily authorable self-study, learner-adaptive, low-stakes quiz extensions for Wikiversity and other projects.<br />
<br />
=== Syntax ===<br />
<br />
GIFT quiz questions must be encoded in utf-8 characters, and are delimited by blank lines. A question may be preceded by a title inside a pair of double colons and must include or be followed by an answer specification in curly braces. Examples are shown below.<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // text || Comment until end of line (optional)<br />
|-<br />
| ::title:: || Question title (optional)<br />
|-<br />
| text || Question text (becomes title if no title specified)<br />
|-<br />
| { || Start answer(s) -- without any answers, text is a description of following questions<br />
|-<br />
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}<br />
|-<br />
| { ... =right ... } || Correct answer for multiple choice, (multiple answer?) or fill-in-the-blank<br />
|-<br />
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer<br />
|-<br />
| { ... =item -> match ... } || Answer for matching questions<br />
|-<br />
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers<br />
|-<br />
| {# || Start numeric answer(s)<br />
|-<br />
| answer:tolerance || Numeric answer accepted within ± tolerance range<br />
|-<br />
| low..high || Lower and upper range values of accepted numeric answer <br />
|-<br />
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer<br />
|-<br />
| } || End answer(s); additional text may follow for fill-in-the-blank<br />
|-<br />
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :<br />
|-<br />
| \n || Places a newline in question text -- blank lines delimit questions<br />
|}<br />
<br />
==== Examples ====<br />
<br />
// true-false<br />
::Q1:: 1+1=2 {T} // not sure if comments are okay here<br />
<br />
// multiple choice with specific feedback<br />
::Q2:: What's between orange and green in the spectrum?<br />
{=yellow # correct! ~red # wrong, it's yellow ~blue # wrong, it's yellow}<br />
<br />
// fill-in-the-blank<br />
::Q3:: Two plus {=two =2} equals four.<br />
<br />
// matching<br />
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }<br />
<br />
// math range question -- note: {#1..5} is the same range<br />
::Q5:: What is a number from 1 to 5? {#3:2}<br />
<br />
// multiple numeric answers with partial credit and feedback<br />
::Q7:: When was Ulysses S. Grant born? {#<br />
=1822:0 # Correct! You get full credit.<br />
=%50%1822:2 # He was born in 1822. You get half credit for being close.<br />
}<br />
<br />
// essay<br />
::Q8:: How are you? {}<br />
<br />
// alternate layout<br />
::Title <br />
:: Question {<br />
=Correct answer 1<br />
=Correct answer 2<br />
~Wrong answer 1<br />
#Response to wrong answer 1<br />
~Wrong answer 2<br />
#Response to wrong answer 2<br />
}<br />
<br />
:''Note: the table and examples above were adapted from and then migrated back to the GPL-licensed Moodle site, not copied from there.''<br />
<br />
=== Categories ===<br />
<br />
Question categories may be specified by preceding them with <br />
<br />
<code><br />
$CATEGORY: path/name<br />
</code><br />
<br />
with a blank line before and after. That sets the following questions' category name or pathname.<br />
<br />
=== Case insensitive ===<br />
<br />
Alphabetic case-sensitive comparison is off by default, but may be enabled for short answer (fill-in-the-blank) questions that need them (usually a very unlikely occurrence, except, e.g., in some chemical formulae like proteins) with:<br />
<br />
<code><br />
$question->usecase = 1;<br />
</code><br />
<br />
=== Extensions ===<br />
<br />
Please help sponsor these extensions at http://talknicer.com<br />
<br />
==== Learner adaptation ====<br />
<br />
Still to be done to extend the format for [http://en.wikipedia.org/wiki/Computerized_adaptive_testing computerized adaptive testing] (per, for example, del Soldato, T. & du Boulay, B. (1995) "Implementation of Motivational Tactics in Tutoring Systems," ''Journal of Artificial Intelligence in Education,'' '''6'''(4): 337-78) is to add optional prerequisite and relative difficulty links to other questions (titles can be used) and optional question help text at two levels of specificity:<br />
<br />
{|<br />
! Symbols !! Use<br />
|-<br />
| // helps-answer: title[, title...] || Set of questions which help answer this question<br />
|-<br />
| // helped-by: title[,...] || Set of questions which answering this question helps answer<br />
|-<br />
| // easier-than: title[%n%][,...] <br /> // harder-than: title[%n%][,...] || Sets of relations to other questions by relative difficulty<br />
|-<br />
| // general-help: text || Optional general help<br />
|-<br />
| // specific-help: text || Optional specific help<br />
|-<br />
| \// || Two forward slashes, not a comment<br />
|-<br />
| // review-state: text || Summary of accuracy review status (see below)<br />
|}<br />
<br />
Can some of the directed graph of which questions assist in the answering of other questions be derived from categorization or must it be stored completely explicitly?<br />
<br />
==== Accuracy review ====<br />
<br />
It would also help to be able to specify the state of the question in a [http://strategy.wikimedia.org/wiki/Proposal:Develop_systems_for_accuracy_review review system]:<br />
<br />
* incomplete<br />
** (ungrammatical, ambiguous, non-sequitur, implies false assumption, circular, dependent on future circumstance or decision, etc.)<br />
* open<br />
** hypothetical (also open -- but less so?)<br />
** answered ("proposed"?)<br />
*** reviewed<br />
**** complete (passed review)<br />
***** asked<br />
****** scored<br />
******* challenged<br />
******** assessed<br />
**** rejected (failed review or assessment)<br />
<br />
[http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content (source)]<br />
<br />
==== Examples ====<br />
<br />
Comments with special hyphenated keywords with colons can be used preceding or following the questions as long as blank lines don't intervene. For example:<br />
<br />
// helps-answer: latte-color // helps if you know this to answer that<br />
::milk-color // title; not sure if comment ok here <br />
// easier-than: sky-color, // this question is easier than those two<br />
// shroedinger-eqn%1% // numeric quantity for relative difficulty<br />
:: What color is milk? { // question<br />
=white // answer<br />
}<br />
// general-help: Think about full milk bottles. // general help<br />
// specific-help: It's the same color as chalk. // specific help<br />
// review-state: proposed // summary of review status<br />
<br />
That would apparently cover the stated extension requirements. The reflexive links (helps/helped, easier/harder) can be implicit where they aren't specified. Not sure whether it's a good idea to specify [http://strategy.wikimedia.org/wiki/Proposal_talk:Assessment_content#assessment_item_fields summary statistics from question fields] as they might exist in a database. Maybe that should be specified but discouraged in practice, because some of the metadata grows every time a question is answered.<br />
<br />
==== Include ====<br />
<br />
Some way to include GIFT files at other locations would be nice. Perhaps: <tt>// include:</tt>[filename|url|wikipage]<br />
<br />
=== Notes for further work ===<br />
<br />
The score-based computer adaptive testing process already implemented in Moodle may be much simpler and easier to re-implement than del Soldato and du Boulay's 1995 [[gift-syntax/dsd-tutor-rules|rules]] -- which require assessment of confidence (self-reported), effort (logging), and independence (frequency of help requests) instead of just scoring questions -- and [[gift-syntax/dsd-tutor-schema|this schema]] based on those rules and the ''Journal of Artificial Intelligence in Education'' article they appeared in. But the primary goals listed here are likely satisfied with the detail shown above.<br />
<br />
There is more we may want to accomplish noted in the [http://en.wikipedia.org/wiki/Spacing_effect "Spacing effect"] Wikipedia article and [http://en.wikipedia.org/wiki/Bloom%27s_Taxonomy#Cognitive "Bloom's cognitive taxonomy,"] suggesting sub-categories.<br />
<br />
; Please disregard posting character counts here<br />
<br />
I asked for a count of the characters @, !, $, *, ;, and _ in {answer specifications} at http://moodle.org/mod/forum/discuss.php?d=143213 -- if you are responding, please never mind. Thanks anyway! [[User:JSalsman|JSalsman]] 22:27, 10 February 2010 (UTC)<br />
<br />
===See also===<br />
<br />
*http://www.mediawiki.org/wiki/Extension:Quiz<br />
**[http://www.mediawiki.org/wiki/Extension_talk:Quiz#GIFT_format_and_Quiz_tables.3F Mediawiki Quiz extension talk: GIFT format and Quiz tables?]<br />
**[https://bugzilla.wikimedia.org/show_bug.cgi?id=22475 Mediawiki bug (enhancement request) 22475]<br />
*[http://strategy.wikimedia.org/wiki/Proposal:Assessment_content Wikimedia assessment content proposal]<br />
**http://en.wikiversity.org/wiki/Help:Quiz<br />
**[http://en.wikiversity.org/wiki/Help:Quiz/Wikiversity_compared_to_Moodle Wikiversity compared to Moodle]<br />
**http://en.wikiversity.org/wiki/Category:Quizzes<br />
<br />
*[http://buypct.com/gift_reference.pdf 5-page reference] (PDF)<br />
<br />
*[[picoformats]]</div>Jsalsman