OfficeDev · Nnoeyy · Nov 1, 2017 · Nov 2, 2017 · Nov 2, 2017 · Nov 2, 2017
diff --git a/EDUGraphAPIs/Assignments/GettingStarted.md b/EDUGraphAPIs/Assignments/GettingStarted.md
diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_delete.md b/EDUGraphAPIs/Assignments/api/educationassignment_delete.md
@@ -1,6 +1,6 @@
 # Delete educationAssignment
 
-Use this API to delete an existing Assignment.  No request body is necessary.  Only Teachers within a Class can delete Assignments.
+Delete an existing assignment. Only teachers within a class can delete assignments.
 
 ## Permissions
 One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
@@ -13,9 +13,9 @@ One of the following permissions is required to call this API. To learn more, in
 
 ## HTTP request
 
-```http
 <!-- { "blockType": "ignored" } -->
 
+```http
 DELETE /education/classes/<id>/assignments/<id>
 ```
 ## Request headers
@@ -28,26 +28,30 @@ Do not supply a request body for this method.
 
 
 ## Response
-If successful, this method returns `204, No Content` response code. It does not return anything in the response body.
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
 
 ## Example
 ##### Request
-Here is an example of the request.
+The following is an example of the request.
 
-```http
 <!-- {
   "blockType": "request",
   "name": "delete_educationassignment"
 }-->
 
+```http
 DELETE https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>
 ```
 ##### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+The following is an example of the response. 
+
+>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
 <!-- {
   "blockType": "response",
   "truncated": true
 } -->
+
 ```http
 HTTP/1.1 204 No Content
 ```

diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_get.md b/EDUGraphAPIs/Assignments/api/educationassignment_get.md
@@ -1,16 +1,11 @@
 # Get educationAssignment
 
-Use this API to get an assignment properties and its relationships.  Students can only see assignments assigned to them while teachers can see all assignments in a class.
+Get the properties and relationships of an assignment. Students can only see assignments assigned to them; teachers can see all assignments in a class.
 
 ## Permissions
 One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
 
 
-
->**Note:** Due to a bug, the graph will return educationItemBody for the instructions property.  This is an exact duplicate of the itemBody that 
-is already found on the graph. When the code moves to production, this will be updated. For clients who simply use the json being sent back and forth to the graph, there should be no work necessary to handle this change.
-
-
 |Permission type      | Permissions (from least to most privileged)              |
 |:--------------------|:---------------------------------------------------------|
 |Delegated (work or school account) | EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite |
@@ -37,7 +32,7 @@ Do not supply a request body for this method.
 If successful, this method returns a `200 OK` response code and [educationAssignment](../resources/educationassignment.md) object in the response body.
 ## Example
 ##### Request
-Here is an example of the request.
+The following is an example of the request.
 <!-- {
   "blockType": "request",
   "name": "get_educationassignment"
@@ -46,7 +41,10 @@ Here is an example of the request.
 GET https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>
 ```
 ##### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+The following is an example of the response. 
+
+>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
 <!-- {
   "blockType": "response",
   "truncated": true,
@@ -73,7 +71,6 @@ Content-length: 279
   "instructions": {"@odata.type": "microsoft.graph.itemBody"},
   "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
   "lastModifiedDateTime": "String (timestamp)",
-  "resourcesFolderUrl": "String",
   "status": "string"
 }
 ```

diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_getResourcesFolderUrl.md b/EDUGraphAPIs/Assignments/api/educationassignment_getResourcesFolderUrl.md
@@ -0,0 +1,70 @@
+# educationAssignment: getResourcesFolderUrl
+
+This function returns the OneDrive URL where all file-based resources (Word, Excel, and so on) should be uploaded.  
+Note that files must be located in this folder in order to be added as resources. Only a teacher in the class can determine what files to upload. 
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
+
+|Permission type      | Permissions (from least to most privileged)              |
+|:--------------------|:---------------------------------------------------------|
+|Delegated (work or school account) |  EduAssignments.ReadBasic, EduAssignments.Read  |
+|Delegated (personal Microsoft account) |  Not supported.  |
+|Application | Not supported. | 
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/<id>/assignments/<id>/getResourcesFolderUrl
+
+```
+## Request headers
+| Header       | Value |
+|:---------------|:--------|
+| Authorization  | Bearer {token}. Required.  |
+
+## Request body
+Do not supply a request body for this method.
+## Response
+If successful, this method returns a `200 Ok` response code. The body will contain the OneDrive URL of a folder in which to put all file-based resources.
+
+## Example
+The following example shows how to call this API.
+##### Request
+The following is an example of a request.
+<!-- {
+  "blockType": "request",
+  "name": "educationassignment_publish"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>/getResourcesFolderUrl
+```
+
+##### Response
+The following is an example of a response. 
+
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "microsoft.graph.educationAssignment"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+Content-length: 279
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Edm.String",
+    "value": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T"
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!-- {
+  "type": "#page.annotation",
+  "description": "educationAssignment: publish",
+  "keywords": "",
+  "section": "documentation",
+  "tocPath": ""
+}-->
diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_list_resources.md b/EDUGraphAPIs/Assignments/api/educationassignment_list_resources.md
@@ -27,10 +27,10 @@ This method supports the [OData Query Parameters](http://graph.microsoft.io/docs
 ## Request body
 Do not supply a request body for this method.
 ## Response
-If successful, this method returns a `200 OK` response code and collection of [educationAssignmentResource](../resources/educationassignmentresource.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [educationAssignmentResource](../resources/educationassignmentresource.md) objects in the response body.
 ## Example
 ##### Request
-Here is an example of the request.
+The following is an example of the request.
 <!-- {
   "blockType": "request",
   "name": "get_resources"
@@ -39,7 +39,10 @@ Here is an example of the request.
 GET https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>/resources
 ```
 ##### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+The following is an example of the response. 
+
+>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
 <!-- {
   "blockType": "response",
   "truncated": true,

diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_list_submissions.md b/EDUGraphAPIs/Assignments/api/educationassignment_list_submissions.md
@@ -1,6 +1,6 @@
 # List submissions
 
-List all the submissions associated with this assignment.  A teacher can get all of the submissions while a student can only get submissions that they are associated with.
+List all the submissions associated with this assignment. A teacher can get all the submissions while a student can only get submissions that they are associated with.
 
 ## Permissions
 One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
@@ -30,7 +30,7 @@ Do not supply a request body for this method.
 If successful, this method returns a `200 OK` response code and collection of [educationSubmission](../resources/educationsubmission.md) objects in the response body.
 ## Example
 ##### Request
-Here is an example of the request.
+The following is an example of the request.
 <!-- {
   "blockType": "request",
   "name": "get_submissions"
@@ -39,7 +39,10 @@ Here is an example of the request.
 GET https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>/submissions
 ```
 ##### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+The following is an example of the response. 
+
+>**Note:** The response object shown here might be shortened for readability. All of the properties will be returned from an actual call.
+
 <!-- {
   "blockType": "response",
   "truncated": true,

diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_post_resources.md b/EDUGraphAPIs/Assignments/api/educationassignment_post_resources.md
@@ -1,6 +1,6 @@
 # Create educationAssignmentResource
 
-Create an assignment resource. The **Assignment** resource is a wrapper around the resource that the teacher wants to add to the assignment with the "distributeForStudentWork" flag which indicates whether this resource should be automatically copied to each student's submission during the assignment process. Items which indicate distribution will be the basis for work that each student should modify to complete the assignment. The resource itself has an @odata.type to indicate which type of resource is being created.  Note that file based resources must first be uploaded to the assignments "resourceFolder"
+Create an [assignment resource](../resources/educationassignmentresource.md). The resource itself has an @odata.type to indicate which type of resource is being created. Note that file-based resources must first be uploaded to the assignments **resourceFolder**.
 
 ## Permissions
 One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
@@ -23,15 +23,15 @@ POST /education/classes/<id>/assignments/<id>/resources
 | Content-Type  | application/json  |
 
 ## Request body
-In the request body, supply a JSON representation of [educationAssignmentResource](../resources/educationassignmentresource.md) object.
+In the request body, supply a JSON representation of the [educationAssignmentResource](../resources/educationassignmentresource.md) object.
 
 
 ## Response
-If successful, this method returns `201, Created` response code and [educationAssignmentResource](../resources/educationassignmentresource.md) object in the response body.
+If successful, this method returns a `201 Created` response code and an [educationAssignmentResource](../resources/educationassignmentresource.md) object in the response body.
 
 ## Example
 ##### Request
-Here is an example of the request.
+The following is an example of the request.
 <!-- {
   "blockType": "request",
   "name": "create_educationassignmentresource_from_educationassignment"
@@ -50,11 +50,12 @@ Content-length: 822
   }
 }
 ```
-In the request body, supply a JSON representation of [educationAssignmentResource](../resources/educationassignmentresource.md) object.
+In the request body, supply a JSON representation of the [educationAssignmentResource](../resources/educationassignmentresource.md) object.
 ##### Response
-Here is an example of the response. 
+The following is an example of the response. 
+
+>**Note:** The response object shown here might be shortened for readability. All of the properties will be returned from an actual call.
 
->**Note:** The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
 
 ```http
 <!-- {

diff --git a/EDUGraphAPIs/Assignments/api/educationassignment_publish.md b/EDUGraphAPIs/Assignments/api/educationassignment_publish.md
@@ -1,6 +1,6 @@
 # educationAssignment: publish
 
-This action changes the state of an assignment from its original draft status to the published status.  Only a teacher in the class can make this call.  When an assignment is in draft status, students will not see the assignment nor will there be any submission objects.  By calling this api, submission objects will be created and the assignment will show up in the student's list.
+This action changes the state of an assignment from its original draft status to the published status. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. When you call this API submission object is created and the assignment appears in the student's list.
 
 ## Permissions
 One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](../../../concepts/permissions_reference.md).
@@ -25,12 +25,12 @@ POST /education/classes/<id>/assignments/<id>/publish
 ## Request body
 
 ## Response
-If successful, this method returns `204, No Content` response code. It does not return anything in the response body.
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
 
 ## Example
-Here is an example of how to call this API.
+The following example shows how to call this API.
 ##### Request
-Here is an example of the request.
+The following is an example of a request.
 <!-- {
   "blockType": "request",
   "name": "educationassignment_publish"
@@ -40,7 +40,8 @@ POST https://graph.microsoft.com/beta/education/classes/<id>/assignments/<id>/pu
 ```
 
 ##### Response
-If successful, this method returns `204, No Content` response code. It does not return anything in the response body.
+The following is an example of a response. 
+
 <!-- {
   "blockType": "response",
   "truncated": true,