Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Improved Question Bank Tags: Difference between revisions

From MoodleDocs
m (→‎Design: label -> tag)
Line 12: Line 12:
Must:
Must:


* As a teacher, I can add a label(s) to a question bank question for use in my course for organizational and search/filtering of questions.
* As a teacher, I can add tag(s) to a question bank question for use in my course for organizational and search/filtering of questions.
* As a teacher, I can filter my questions in courses based on labels.
* As a teacher, I can filter my questions in courses based on tags.
* As a teacher, I can see labels on questions at higher category assigned by Question sharer role holder.
* As a teacher, I can see tags on questions at higher category assigned by Question sharer role holder.
* As another teacher in the same course, I have access to the question labels on the questions in that course context.
* As another teacher in the same course, I have access to the question tags on the questions in that course context.
* As a teacher in a course, I do not see labels of other in contexts I do not have access to. (Instructor 1’s “midterm 1” question set would not be relevant to Instructor 2)
* As a teacher in a course, I do not see tags of other in contexts I do not have access to. (Instructor 1’s “midterm 1” question set would not be relevant to Instructor 2)
* As a teacher, I am able to add/modify/remove labels on questions.
* As a teacher, I am able to add/modify/remove tags on questions.
* As a teacher, I should not have to copy a question into my course from higher category contexts to include it in a ‘random question from question set’ question type.
* As a teacher, I should not have to copy a question into my course from higher category contexts to include it in a ‘random question from question set’ question type.
* As a teacher, I can add a 'random question from question set' question type to my quiz where the question set is a selectable list of questions. These questions can be searched for and filtered by label but the set itself is not defined by specifying a label.
* As a teacher, I can add a 'random question from question set' question type to my quiz where the question set is a selectable list of questions. These questions can be searched for and filtered by tag but the set itself is not defined by specifying a tag.


Nice to have:
Nice to have:
* Labels can contain any visible ASCII characters including characters such as apostrophes, slashes, and colons. Exception of Comma.
* Labels can contain any visible ASCII characters including characters such as apostrophes, slashes, and colons. Exception of Comma.
* As a teacher, when searching for questions to add to a ‘random question from question set’ I see the question with its context clearly visible.
* As a teacher, when searching for questions to add to a ‘random question from question set’ I see the question with its context clearly visible.
* As a teacher, I can export/import questions with their labels.
* As a teacher, I can export/import questions with their tags.
* As a Question sharer role holder, I can add a label(s) to a question bank questions that exist at the category context.
* As a Question sharer role holder, I can add a tag(s) to a question bank questions that exist at the category context.
* As a Question sharer role holder, I can search/filter all the questions I have access to and see them along with their context.
* As a Question sharer role holder, I can search/filter all the questions I have access to and see them along with their context.



Revision as of 02:31, 16 October 2017

Overview

This document is "under construction" (really!)

This document is the technical design for a set of features proposed by the Moodle Users Association for Moodle 3.5.

The project proposal is here: https://moodleassociation.org/mod/page/view.php?id=465

The requirements / user stories have been written by the MUA - a copy is included here for clarity

User Stories / Requirements

Must:

  • As a teacher, I can add tag(s) to a question bank question for use in my course for organizational and search/filtering of questions.
  • As a teacher, I can filter my questions in courses based on tags.
  • As a teacher, I can see tags on questions at higher category assigned by Question sharer role holder.
  • As another teacher in the same course, I have access to the question tags on the questions in that course context.
  • As a teacher in a course, I do not see tags of other in contexts I do not have access to. (Instructor 1’s “midterm 1” question set would not be relevant to Instructor 2)
  • As a teacher, I am able to add/modify/remove tags on questions.
  • As a teacher, I should not have to copy a question into my course from higher category contexts to include it in a ‘random question from question set’ question type.
  • As a teacher, I can add a 'random question from question set' question type to my quiz where the question set is a selectable list of questions. These questions can be searched for and filtered by tag but the set itself is not defined by specifying a tag.

Nice to have:

  • Labels can contain any visible ASCII characters including characters such as apostrophes, slashes, and colons. Exception of Comma.
  • As a teacher, when searching for questions to add to a ‘random question from question set’ I see the question with its context clearly visible.
  • As a teacher, I can export/import questions with their tags.
  • As a Question sharer role holder, I can add a tag(s) to a question bank questions that exist at the category context.
  • As a Question sharer role holder, I can search/filter all the questions I have access to and see them along with their context.

Design

The requirements listed above can be met by implementing the following changes (which are described in detail further down):

  • New question type "Random question from a set of questions"
  • Enhanced question search allowing search/filter by tag everywhere
  • ? Allow adding tags to questions from a higher context (I need to re-read the discussion to confirm this one)?