Significant events module for Open edX
Project description
edx-milestones [![Build Status](https://travis-ci.org/edx/edx-milestones.svg?branch=master)](https://travis-ci.org/edx/edx-milestones) [![Coverage Status](https://img.shields.io/coveralls/edx/edx-milestones.svg)](https://coveralls.io/r/edx/edx-milestones?branch=master)
===================
edx-milestones (`milestones`) is a Django application which manages significant Course and/or Student events in the Open edX platform.
Usage
-----
* A Milestone represents an event which can occur for a student while interacting with the Open edX platform.
* Relationships can be created between courses or individual sections of course content (referred to collectively as course entities going forward) and a Milestone. A relationship can indicate that a course entity either requires or fulfills a given Milestone.
* Student milestone fulfillment status can be recorded and queried.
* An example feature which Milestones supports is Pre-requisite Courses:
* Course author selects Course 101 in Studio as a pre-requisite of Course 102
* Studio:
* Makes call to Milestones service API
* Milestones:
* Creates a new generic Milestone A for Course 101
* Indicates that Course 101 fulfills Milestone A
* Indicates that Course 102 requires Milestone A
* Student Smith completes Course 101
* LMS:
* Makes call to Milestones service API
* Milestones:
* Pulls the list of milestones fulfilled by Course 101 (set includes Milestone A)
* Indicates that Student Smith has accomplished Milestone A
* Student Smith attempts to access Course 102
* LMS:
* Uses Milestones service API to compare Course 102 milestone requirements against Student Smith's milestones
* Grants Student Smith access to Course 102
Standalone Testing and Quality Check
------------------------------------
$ make quality
$ make test
Open edX Platform Integration
-----------------------------
* Add desired tag from github code repository
* edx-platform/requirements/github.txt
* "Our libraries" section
* Add 'milestones' to the list of installed apps:
* common.py
* Feature flag convention is preferred
* In edx-platform devstack:
* pip install -r requirements
* paver test_system -s lms
How to Contribute
-----------------
Contributions are very welcome, but please note that edx-milestones is currently an
early stage work-in-progress and is changing frequently at this time.
See our
[CONTRIBUTING](https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst)
file for more information -- it also contains guidelines for how to maintain
high code quality, which will make your contribution more likely to be accepted.
Reporting Security Issues
-------------------------
Please do not report security issues in public. Please email security@edx.org.
Mailing List and IRC Channel
----------------------------
You can discuss this code on the [edx-code Google Group](https://groups.google.com/forum/#!forum/edx-code) or in the
`edx-code` IRC channel on Freenode.
===================
edx-milestones (`milestones`) is a Django application which manages significant Course and/or Student events in the Open edX platform.
Usage
-----
* A Milestone represents an event which can occur for a student while interacting with the Open edX platform.
* Relationships can be created between courses or individual sections of course content (referred to collectively as course entities going forward) and a Milestone. A relationship can indicate that a course entity either requires or fulfills a given Milestone.
* Student milestone fulfillment status can be recorded and queried.
* An example feature which Milestones supports is Pre-requisite Courses:
* Course author selects Course 101 in Studio as a pre-requisite of Course 102
* Studio:
* Makes call to Milestones service API
* Milestones:
* Creates a new generic Milestone A for Course 101
* Indicates that Course 101 fulfills Milestone A
* Indicates that Course 102 requires Milestone A
* Student Smith completes Course 101
* LMS:
* Makes call to Milestones service API
* Milestones:
* Pulls the list of milestones fulfilled by Course 101 (set includes Milestone A)
* Indicates that Student Smith has accomplished Milestone A
* Student Smith attempts to access Course 102
* LMS:
* Uses Milestones service API to compare Course 102 milestone requirements against Student Smith's milestones
* Grants Student Smith access to Course 102
Standalone Testing and Quality Check
------------------------------------
$ make quality
$ make test
Open edX Platform Integration
-----------------------------
* Add desired tag from github code repository
* edx-platform/requirements/github.txt
* "Our libraries" section
* Add 'milestones' to the list of installed apps:
* common.py
* Feature flag convention is preferred
* In edx-platform devstack:
* pip install -r requirements
* paver test_system -s lms
How to Contribute
-----------------
Contributions are very welcome, but please note that edx-milestones is currently an
early stage work-in-progress and is changing frequently at this time.
See our
[CONTRIBUTING](https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst)
file for more information -- it also contains guidelines for how to maintain
high code quality, which will make your contribution more likely to be accepted.
Reporting Security Issues
-------------------------
Please do not report security issues in public. Please email security@edx.org.
Mailing List and IRC Channel
----------------------------
You can discuss this code on the [edx-code Google Group](https://groups.google.com/forum/#!forum/edx-code) or in the
`edx-code` IRC channel on Freenode.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
edx-milestones-0.1.13.tar.gz
(32.3 kB
view hashes)
Built Distribution
Close
Hashes for edx_milestones-0.1.13-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0eb2d7b69efc2d3a5cdc3d4a07eec16f09deba960b4320104be75a6adee62309 |
|
MD5 | 58a24843bee208013cdd42dfce8eb231 |
|
BLAKE2b-256 | 6439148b1dac4fffb270fe28d9c71595eca6ccd17840f62332e62569eec86a17 |