Development:Workshop 2.0 specification: Difference between revisions
David Mudrak (talk | contribs) |
David Mudrak (talk | contribs) No edit summary |
||
Line 107: | Line 107: | ||
* [http://moodle.org/mod/forum/discuss.php?d=81956 the new workshop module] forum thread | * [http://moodle.org/mod/forum/discuss.php?d=81956 the new workshop module] forum thread | ||
* [http://moodle.org/mod/forum/discuss.php?d=43808 a lot of interesting feature requests] | * [http://moodle.org/mod/forum/discuss.php?d=43808 a lot of interesting feature requests] | ||
==Diagram used== | |||
* [[Image:workshop20_uml_usecases.dia]] | |||
=Credits= | =Credits= | ||
Many thanks to Stephan Rinke for his valuable comments and ideas. | Many thanks to Stephan Rinke for his valuable comments and ideas. |
Revision as of 15:50, 22 April 2009
Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.
Template:Moodle 2.0
This page tracks and summarizes the progress of my attempt to try and rewrite the Workshop module for Moodle 2.0 (yes, yet another attempt).
PROJECT STATE: Planning
Introduction
TODO: some short summary of what workshop is and what it does. The module with a huge pedagogical potential. The key features are:
- advanced grading methods (criterial evaluation)
- peer-assessment
Current implementation problems
- Very old and unmaintained code - the vast majority of the code is the same as it was in Moodle 1.1. mforms are not used (accessibility). Missing modularity. No unit testing.
- Does not talk with the Gradebook - there are some patches around in forums fixing partial problems.
- User interface and usability
- Grades calculation is kind of dark magic - see this discussion. It is not easy to understand the way how Workshop calculates the grading grade even if you read the code that actually does the calculation. More than that, the whole algorithm depends on a set of strange constants without any explanation or reasoning of the value. The grade calculation must be clear and easy to understand to both teacher and student. Teachers must be always able to explain why students got their final grades. Therefore the plan is to get rid of the fog above the grades calculation, even if it breaks backward compatibility.
- Lack of custom scales support - see this discussion
- Phases overlapping, balancing, overall allocation issues - see this discussion
Project analysis
See the project analysis mindmap
Project schedule
Milestone 1
- Date: 15/05/2009
- Goal: The functional specification is in docs wiki and is reviewed and agreed by the community and Moodle HQ. The implementation plan is transferred into sub-tasks in the tracker.
Milestone 2
- Date: 15/07/2009
- Goal: All features implemented. The community is asked for the testing.
Milestone 3
- Date: 15/08/2009
- Goal: Major bugs fixed, upgrading from pre-2.0 versions works. The community is asked for the QA testing.
Milestone 4
- Date: 15/09/2009
- Goal: The module is moved from contrib back to the core.
User interaface mockups
Implementation plan
The structure of the code
Files, libraries, interfaces, classes, unit tests
DB tables
Capabilities
File API integration
How Workshop will use the new File API.
Repository/portfolio API integration
If and how will be implemented.
Grading strategies
We are currently working on this part of specification, see - the Google doc
Pluggable submodules in mod/workshop/grading/xxxx/. Implement grading_strategy interface. Basically provide grading form and way of grade calculation. During the current phase, four strategies will be implemented (the names are to discuss)
See MDL-18912 for UI mockups of grading forms.
No grading
Just comment(s)
Accumulative
Number of errors
Currently called Error banded
Criterial rubrics
Merges the current Rubrics and Criterion strategy into a single one (basically, current Criterion is an one-dimensional Rubrics)
Out of scope
What are not goals of this project (may be discussed later for 2.1 etc.)
- No new/other grading strategies are to implement in the current phase
- No new Workshop features will be implemented (if possible)
- No group grading support
To be discussed/decided
Other links and resources
- MDL-17827 Workshop upgrade/conversion from 1.9 to 2.0 (META)
- Yet another attempt to rewrite Workshop for 2.0 forum thread
- New Workshop Module forum thread
- the new workshop module forum thread
- a lot of interesting feature requests
Diagram used
Credits
Many thanks to Stephan Rinke for his valuable comments and ideas.