Preliminary work for Course Catalog API documentation

docs/en_us/platform_api/source/course_catalog/index.rst

+.. _edX Platform Course Catalog API:
+
+#####################################
+Course Catalog API Version 1.0
+#####################################
+
+.. toctree::
+    :maxdepth: 2
+
+    course_field_specification
+    course_run_field_specification
+    supporting_object_field_specification
+

docs/en_us/platform_api/source/enrollment/course_field.rst

+#########################################################
+Course Catalog API Course Field Specification Resource
+#########################################################
+
+*************************
+*************************
+All of the text in this file is placeholder text for formatting. Need more information at https://docs.google.com/document/d/11b8Qty8S7GF55QP-yagKi3zdAZGYd-gWYLEwBwxLZQk/edit before I can proceed.
+*************************
+*************************
+
+With the Enrollment API **Enrollment** resource, you can complete the
+following tasks.
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+.. _Get the Users Enrollment Status in a Course:
+
+********************************************
+Get the User's Enrollment Status in a Course
+********************************************
+
+.. autoclass:: enrollment.views.EnrollmentView
+
+**Example response showing the user's enrollment status in a course**
+
+.. code-block:: json
+
+    HTTP 200 OK
+    Content-Type: application/json
+    Vary: Accept
+    Allow: GET, HEAD, OPTIONS
+
+    {
+        "created": "2014-11-19T04:06:55Z",
+        "mode": "honor",
+        "is_active": true,
+        "course_details": {
+            "course_id": "edX/DemoX/Demo_Course",
+            "enrollment_end": null,
+            "course_modes": [
+                {
+                    "slug": "honor",
+                    "name": "Honor Code Certificate",
+                    "min_price": 0,
+                    "suggested_prices": [],
+                    "currency": "usd",
+                    "expiration_datetime": null,
+                    "description": null
+                }
+            ],
+            "enrollment_start": null,
+            "invite_only": false
+        },
+        "user": "staff"
+    }
+
+.. _Get Enrollment Details for a Course:
+
+**************************************************
+Get the User's Enrollment Information for a Course
+**************************************************
+
+.. autoclass:: enrollment.views.EnrollmentCourseDetailView
+
+**Example response showing a user's course enrollment information**
+
+.. code-block:: json
+
+    HTTP 200 OK
+    Content-Type: application/json
+    Vary: Accept
+    Allow: GET, HEAD, OPTIONS
+
+    {
+        "course_id": "edX/DemoX/Demo_Course",
+        "enrollment_end": null,
+        "course_modes": [
+            {
+                "slug": "honor",
+                "name": "Honor Code Certificate",
+                "min_price": 0,
+                "suggested_prices": [],
+                "currency": "usd",
+                "expiration_datetime": null,
+                "description": null
+            }
+        ],
+        "enrollment_start": null,
+        "invite_only": false
+    }
+
+
+.. _View and add to a Users Course Enrollments:
+
+**********************************************************
+View a User's Enrollments or Enroll a User in a Course
+**********************************************************
+
+.. autoclass:: enrollment.views.EnrollmentListView
+
+
+**Example response showing a user who is enrolled in two courses**
+
+.. code-block:: json
+
+    HTTP 200 OK
+    Content-Type: application/json
+    Vary: Accept
+    Allow: GET, POST, HEAD, OPTIONS
+
+    [
+        {
+            "created": "2014-09-19T18:08:37Z",
+            "mode": "honor",
+            "is_active": true,
+            "course_details": {
+                "course_id": "edX/DemoX/Demo_Course",
+                "enrollment_end": null,
+                "course_modes": [
+                    {
+                        "slug": "honor",
+                        "name": "Honor Code Certificate",
+                        "min_price": 0,
+                        "suggested_prices": [],
+                        "currency": "usd",
+                        "expiration_datetime": null,
+                        "description": null
+                    }
+                ],
+                "enrollment_start": null,
+                "invite_only": false
+            },
+            "user": "honor"
+        },
+        {
+            "created": "2014-09-19T18:09:35Z",
+            "mode": "honor",
+            "is_active": true,
+            "course_details": {
+                "course_id": "ArbisoftX/BulkyEmail101/2014-15",
+                "enrollment_end": null,
+                "course_modes": [
+                    {
+                        "slug": "honor",
+                        "name": "Honor Code Certificate",
+                        "min_price": 0,
+                        "suggested_prices": [],
+                        "currency": "usd",
+                        "expiration_datetime": null,
+                        "description": null
+                    }
+                ],
+                "enrollment_start": "2014-05-01T04:00:00Z",
+                "invite_only": false
+            },
+            "user": "honor"
+        }
+    ]
+
+
+**Example response showing that a user has been enrolled in a new course**
+
+.. code-block:: json
+
+    {
+        "course_details": {
+            "course_id": "edX/DemoX/Demo_Course"
+        }
+    }