EDUCATOR-894

The API docs were broken by the Django 1.11 upgrade. This change includes an upgrade to the most recent version of django-rest-swagger that supports DRF 3.4. Newer versions of django-rest-swagger require DRF 3.5.

This change is complicated by a decision made by the maintainers of the django-filter package to avoid subclassing DRF's DjangoFilterBackend. For more on that decision, see https://github.com/carltongibson/django-filter/pull/576. The SchemaGenerator from DRF 3.4.7 expects instances of DjangoFilterBackend to have a get_fields() method. The DjangoFilterBackend from django-filter 1.0.4 doesn't have this method, instead replacing it with the get_schema_fields() used by the SchemaGenerator in DRF 3.5. To work around this, I've replaced our one use django-filter's DjangoFilterBackend with DRF's DjangoFilterBackend. Note that DRF 3.5 removes its implementation of DjangoFilterBackend in favor of django-filter's, so we will have to change how we import DjangoFilterBackend when we upgrade to 3.5.

LEARNER-1590

DRF 3.4.7 is the same version run by edx/credentials. Release notes are at http://www.django-rest-framework.org/topics/release-notes/#34x-series. Highlights include:

1. [Support for Django 1.10](https://github.com/encode/django-rest-framework/pull/4158) - sigh
2. [Support for schema generation](https://github.com/encode/django-rest-framework/pull/4179) - required for newer versions of django-rest-swagger
3. A change that [prevents paginated views from re-running queries](https://github.com/encode/django-rest-framework/issues/4201) when count queries return 0 - this explains the expected query count changes made in tests

LEARNER-1590

Using the default UI for SortedManyToManyField since it properly exposes the sorting capability.

LEARNER-1863

This reverts commit ddd3447e.

This reverts commit a804e243.

LEARNER-1119

EDUCATOR-818

Release notes at https://docs.djangoproject.com/en/1.11/releases/1.11.3/

This change completes a streamlining of the project docs. They're now organized into three sections. The (previously added) introduction provides context to new developers, explaining why the service exists and what it does. The quickstart section covers information new developers need to know to run and develop for the service. The advanced section covers additional, important information that isn't strictly necessary to run the service.

LEARNER-1399

EDUCATOR-716

Version 1.8.0 of django-contrib-comments moved away from
using the SITE_ID settings attribute in favor of supporting
multi-tenancy.

LEARNER-1583 + EDUCATOR-733

This is the first in a series of commits that aims to update this documentation in an effort to make it more useful to other developers and the Open edX community at large. The introduction provides some background information on the discovery service that was missing before. It also explains key concepts necessary to understand the service. This change also brings these docs into line with those written for other services by switching to using the edX theme.

LEARNER-1399

Eliminates need to install Django when building docs.

LEARNER-1399

https://openedx.atlassian.net/browse/EDUCATOR-735

The autocomplete does not allow for the video to be deleted. Since autocomplete is overkill for this field, I have removed it and replaced it with Django's built-in search functionality over raw_id_fields.

LEARNER-1603

This reverts commit e5d26878.

EDUCATOR-723

Version 1.8.0 of django-contrib-comments moved away from
using the SITE_ID settings attribute in favor of supporting
multi-tenancy.

LEARNER-1583

EDUCATOR-717

LEARNER-947

LEARNER-947