Lesson Specification: Difference between revisions
From MoodleDocs
| Line 54: | Line 54: | ||
:'''''Handling of re-takes''''': | :'''''Handling of re-takes''''': | ||
:'''''Display ongoing score''''': | :'''''Display ongoing score''''': | ||
''''' | '''Flow control''' | ||
:'''''Allow student review''''': | |||
:Display review button | :'''''Display review button''''': | ||
:Maximum number of attempts | :'''''Maximum number of attempts''''': | ||
:Action after correct answer | :'''''Action after correct answer''''': | ||
:Display default feedback | :'''''Display default feedback''''': | ||
:Minimum number of questions | :'''''Minimum number of questions''''': | ||
:Number of pages (cards) to show | :'''''Number of pages (cards) to show''''': | ||
'''Lesson formatting''' | |||
:Slide Show | :'''''Slide Show''''': | ||
:Slide show | :'''''Slide show width''''': | ||
: | :'''''Slide show height''''': | ||
:Slide show background | :'''''Slide show background color''''': | ||
:Display left menu | :'''''Display left menu''''': | ||
:and only display if has grade greater than | :'''''and only display if has grade greater than''''': | ||
:Progress Bar | :'''''Progress Bar''''': | ||
'''Access control''' | '''Access control''' | ||
:Password protected lesson | :'''''Password protected lesson''''': | ||
:Password | :'''''Password''''': | ||
:Available from | :'''''Available from''''': | ||
:Day Month Year Hour Minute | :'''''Day Month Year Hour Minute''''': | ||
:Deadline | :'''''Deadline''''': | ||
:Day Month Year Hour Minute | :'''''Day Month Year Hour Minute''''': | ||
'''Dependent on''' | '''Dependent on''' | ||
:Dependent on | :'''''Dependent on''''': | ||
:Time Spent (minutes) | :'''''Time Spent (minutes)''''': | ||
:Completed | :'''''Completed''''': | ||
:Grade better than (%) | :'''''Grade better than (%)''''': | ||
'''Pop-up to file or web page''' | '''Pop-up to file or web page''' | ||
:Pop-up to file or web page | :'''''Pop-up to file or web page''''': | ||
:Show close button: | :'''''Show close button''''': | ||
:Window height: | :'''''Window height''''': | ||
:width: | :'''''width''''': | ||
'''Other''' | '''Other''' | ||
:Link to an activity | :'''''Link to an activity''''': | ||
:Number of high scores | :'''''Number of high scores displayed''''': | ||
:Use this lesson's settings as defaults | :'''''Use this lesson's settings as defaults''''': | ||
'''Common module settings''' | '''Common module settings''' | ||
:Visible | :'''''Visible''''': | ||
:ID number | :'''''ID number''''': | ||
:Grade category | :'''''Grade category''''': | ||
==Issues== | ==Issues== | ||
Revision as of 05:25, 11 June 2008
Functional Specification Revisions:
- 0.1 - 11/06/2008 - Jerome Mouneyrac - Draft Version from existing module in Moodle 1.9
- 1.0 - XX/XX/XXXX - Jerome Mouneyrac - Final Version for 1.9
Audience:
- user/implementer/QA
Status:
- approved/module implemented
Related Documents:
Introduction
Scope of this functional specification
This document is about functional specification for Moodle lesson module.
This document has been written after the Lesson User Manual User. You must read it before this document. Lesson User Manual and this document should be modified when any functional change is operated on the lesson module.
TODO: most of the Lesson User Manual information should be added to this functional specification (in Glossary and Requirements), so we won't need to read this user manual in order to understand this functional specification.
Glossary
All lesson specific terms are explained in the Lesson User Manual
implementer
- The person or team who will turn this specification into a working module.
requirement
- A need or necessary condition of the finished module.
shall
- Used in the Requirements section 'shall' means that the item is absolutely necessary as stated.
should
- Used in the Requirements section 'should' means the item is desirable, but not required. Wishy-washy, but often unavoidable.
TBD
- To Be Decided/Determined.
user
- Person(s) who will deal with the completed module of this specification.
Requirements
Lesson parameters
A lesson shall have the following parameters:
General
- Name: the name of this lesson
- Time limit (minutes): a time limit for any attempt to this lesson. It can be enable or disable.
- Maximum number of answers/branches: the maximum number of branches
Grade options
- Practice lesson:
- Custom scoring:
- Maximum grade:
- Student can re-take:
- Handling of re-takes:
- Display ongoing score:
Flow control
- Allow student review:
- Display review button:
- Maximum number of attempts:
- Action after correct answer:
- Display default feedback:
- Minimum number of questions:
- Number of pages (cards) to show:
Lesson formatting
- Slide Show:
- Slide show width:
- Slide show height:
- Slide show background color:
- Display left menu:
- and only display if has grade greater than:
- Progress Bar:
Access control
- Password protected lesson:
- Password:
- Available from:
- Day Month Year Hour Minute:
- Deadline:
- Day Month Year Hour Minute:
Dependent on
- Dependent on:
- Time Spent (minutes):
- Completed:
- Grade better than (%):
Pop-up to file or web page
- Pop-up to file or web page:
- Show close button:
- Window height:
- width:
Other
- Link to an activity:
- Number of high scores displayed:
- Use this lesson's settings as defaults:
Common module settings
- Visible:
- ID number:
- Grade category:
Issues
User Interface
Creation page
Use Cases
UCXXX-1 Create a lesson
Base scenario
- User selects Add lesson activity operation
- System displays the Add lesson form
- User fills the Add lesson form
- User selects Save operation (Go to course option)
- System displays the lesson page
First Alternative scenario
- Go to step 4
- 4. User selects Save operation (Go to lesson option)
- 5. System displays the course page including the new lesson
Pre conditions
- - the user is on a course page
- - the course editing option is ON
Post conditions
- - An empty lesson has been created
UCXXX-2 Edit a lesson
Base scenario
- ...
- ...
- ...
Pre conditions
- - ...
- - ...
Post conditions
- - ...
