This document lays out the vision for the olxcleaner code.
It is envisioned that this code can be used in many ways to assist with the creation of edX courses.
- Exported courses from Studio can be scanned using this tool in order to pick up errors that are not currently checked by edX (particularly links and dates).
-
Before loading an XML course into Studio, this code can check the XML structure for any errors.
-
This code can be used for error detection by educational technologists to simplify their bug sleuthing.
-
Course statistics and layout can be generated by this code.
-
Content reports can be generated by this tool.
-
Because this code contains a full course parser, it can be used to scan through a course using python data structures for course analysis purposes.
-
For github workflows, a hook could be added to run this script upon branch push, producing an error report automatically.
This code is intended for use by the edX community. Beyond the current possibilities, there are two aspects that should be of value to the community:
-
As errors that aren't detected by this tool are found (likely after some sleuthing), the code can be updated to detect such errors.
-
As new capabilities for edX are developed, the schema for the new possibilities can be added to this tool so that others can ensure that their code is syntactically correct.
-
edX can use a tool such as this to define their OLX schema. When creating new content options, they can be validated by this tool.
-
When loading an XML course into Studio, edX could automatically run this code over the course, and produce an error report.
-
Studio could have a button somewhere that triggers validation by this code (likely after export).