Lesson Specification
Functional Specification Revisions:
- 0.1 - 11/06/2008 - Jerome Mouneyrac - Draft Version from existing module in Moodle 1.9
- 0.2 - XX/XX/XXXX - XXXXXX XXXXXXXXX - Beta Version before validation
- 1.0 - XX/XX/XXXX - XXXXXX XXXXXXXXX - 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 (mandatory fields are marked with *):
General
- Name*: the name of this lesson
- Time limit (minutes): a time limit in minutes for any attempt to this lesson. It can be enable or disable.
- Maximum number of answers/branches: the maximum number of branches for this lesson
Grade options
- Practice lesson:
- Custom scoring:
- Maximum grade: the maximum grade for this lesson (from 0 to 100)
- Student can re-take: are the student allowed to re-take the lesson
- Handling of re-takes:
- Display ongoing score:
Flow control
- Allow student review:
- Display review button:
- Maximum number of attempts: maximum number of attempts for one student (from 1 to 10)
- 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
no known 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 edition 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 user has Admin or Teacher permission a the course
- - the course editing option is ON
Post conditions
- - An empty lesson has been created
UCXXX-2 Update a lesson
Base scenario
- ...
- ...
- ...
Pre conditions
- - ...
- - ...
Post conditions
- - ...
Exceptions
- E1: Another user deleted the course at the same time