Merge pull request SharePoint#1118 from SharePoint/master

Update the docs for 1.4 version

Author: lucabandMSFT

docs/apis/rest/complete-basic-operations-using-sharepoint-rest-endpoints.md

@@ -224,7 +224,8 @@ When you send a POST request, the request must include the form digest value in
 
 Cloud-hosted add-ins use either OAuth or the cross-___domain library to authorize access to SharePoint data. Add-in components with code that runs on a remote web server must use OAuth to authorize access to SharePoint data. In this case, you need to include an  **Authorization** header to send the access token. See [Reading data with the SharePoint REST interface](complete-basic-operations-using-sharepoint-rest-endpoints.md#ReadingData) for an example that adds an authorization header to an **HTTPWebRequest** object.
 
- **Note**  Cloud-hosted add-in components that are written in JavaScript must use the  **SP.RequestExecutor** object in the cross-___domain library to access to SharePoint data. Cross-___domain library requests don't need to include an access token.
+> [!NOTE]
+> Cloud-hosted add-in components that are written in JavaScript must use the  **SP.RequestExecutor** object in the cross-___domain library to access to SharePoint data. Cross-___domain library requests don't need to include an access token.
  
 To learn more about OAuth access tokens and how to get them, see  [Context Token OAuth flow for SharePoint Add-ins](https://msdn.microsoft.com/en-us/library/office/fp142382.aspx) and [Authorization Code OAuth flow for SharePoint Add-ins](https://msdn.microsoft.com/en-us/library/office/jj687470.aspx).
 
@@ -237,7 +238,8 @@ Requests are sent to the resource endpoint that's specified in the  **url** prop
 
 Cross-___domain library requests use this format when they access data on the add-in web, which is the default context for cross-___domain library requests. But to access data on the host web or on another site collection, the requests need to initialize the host web or other site collection as the context. To do this, they use the  **SP.AppContextSite** endpoint in the URI, as shown in Table 1. The example URIs in Table 1 use the **@target** alias to send the target URL in the query string because the URL contains a special character (':').
 
- **Note**  An add-in web instance is required for a cloud-hosted add-in to access SharePoint data when using the cross-___domain library.
+> [!NOTE]
+> An add-in web instance is required for a cloud-hosted add-in to access SharePoint data when using the cross-___domain library.
 
 **Table 1. Using the SP.AppContextSite endpoint to change the context of the request**
 
@@ -248,7 +250,8 @@ Cross-___domain library requests use this format when they access data on the add-i
 |Cloud-hosted|JavaScript add-in component accessing data in a site collection other than the host web by using the cross-___domain library (tenant-scoped add-ins only)| _<app web url>_/_api/SP.AppContextSite(@target)/web/title?@target=' _<target site url>_'|
 |SharePoint-hosted|Add-in web component accessing data in another site collection (tenant-scoped add-ins only)| _<app web url>_/_api/SP.AppContextSite(@target)/web/title?@target=' _<target site url>_'|
 
- **Note**  Cross-___domain data access scenarios also require appropriate add-in permissions. For more information, see  [Access data from the host web](https://msdn.microsoft.com/en-us/library/office/fp179927.aspx#SP15Accessdatafromremoteapp_Hostweb) and [Access data across site collections](https://msdn.microsoft.com/en-us/library/office/fp179927.aspx#SP15Accessdatafromremoteapp_TenantScope).
+> [!NOTE]
+> Cross-___domain data access scenarios also require appropriate add-in permissions. For more information, see  [Access data from the host web](https://msdn.microsoft.com/en-us/library/office/fp179927.aspx#SP15Accessdatafromremoteapp_Hostweb) and [Access data across site collections](https://msdn.microsoft.com/en-us/library/office/fp179927.aspx#SP15Accessdatafromremoteapp_TenantScope).
 
 SharePoint Add-ins can get the add-in web URL and host web URL from the query string of the add-in page, as shown in the following code example. The example also shows how to reference the cross-___domain library, which is defined in the SP.RequestExecutor.js file on the host web. The example assumes that your add-in launches from SharePoint. See  [Authorization Code OAuth flow for SharePoint Add-ins](https://msdn.microsoft.com/en-us/library/office/jj687470.aspx) for guidance on setting your SharePoint context correctly when your add-in does not launch from SharePoint.
 
@@ -317,7 +320,7 @@ Table 2 shows properties that are commonly used in HTTP requests for the SharePo
 <a name="batch"> </a>
 The SharePoint Online (and on-premise SharePoint 2016 and later) REST service supports combining multiple requests into a single call to the service by using the OData  `$batch` query option. For details and links to code samples, see [Make batch requests with the REST APIs](make-batch-requests-with-the-rest-apis.md).
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Working with lists and list items with REST](working-with-lists-and-list-items-with-rest.md)

docs/apis/rest/determine-sharepoint-rest-service-endpoint-uris.md

@@ -218,7 +218,7 @@ The figure below shows the SharePoint REST service static member syntax.
 If you want to select, filter, or order the data you requested from an endpoint, the SharePoint REST service supports a wide range of OData query string operators. 
 
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)

docs/apis/rest/get-to-know-the-sharepoint-rest-service.md

@@ -115,7 +115,7 @@ The following table contains typical REST endpoint URL examples to get you start
 
 The SharePoint Online (and on-premise SharePoint 2016 or later) REST service supports combining multiple requests into a single call to the service by using the OData  `$batch` query option. For details and links to code samples, see [Make batch requests with the REST APIs](make-batch-requests-with-the-rest-apis.md). .
 
-## Additional Resources
+## See also
 <a name="bk_learnmore"> </a>
 Use the resources listed below to learn more about using the SharePoint REST service.
 

docs/apis/rest/navigate-the-sharepoint-data-structure-represented-in-the-rest-service.md

@@ -97,7 +97,7 @@ Navigation that is supported by the REST service:
 |**Title**|Gets or sets the title for the site.|
 |**WebTemplateId**|Gets the identifier of the site template.|
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)

docs/apis/rest/set-custom-permissions-on-a-list-by-using-the-rest-interface.md

@@ -266,7 +266,7 @@ function errorHandler(xhr, ajaxOptions, thrownError) {
 ```
 
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md) 

docs/apis/rest/synchronize-sharepoint-items-using-the-rest-service.md

@@ -61,7 +61,7 @@ The request returns ADO  **rowset** XML which includes rows corresponding to any
 |**ChangeToken**|A string that contains the change token for the request. For a description of the format that is used in this string, see  [Overview of the Change Log](http://msdn.microsoft.com/en-us/library/bb417456.aspx). If null is passed, all items in the list are returned.|
 |**Contains**|A  [Contains](http://msdn.microsoft.com/en-us/library/ms196501.aspx) element that defines custom filtering for the query.|
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)

docs/apis/rest/upload-a-file-by-using-the-rest-api-and-jquery.md

@@ -26,7 +26,8 @@ This process uses the following high-level steps:
 <a name="RunTheExamples"> </a>
 Both code examples in this article use the REST API and jQuery AJAX requests to upload a file to the  **Shared Documents** folder and then change list item properties. The first example uses **SP.AppContextSite** to make calls across SharePoint domains, like a SharePoint-hosted add-in would do when uploading files to the host web. The second example makes same-___domain calls, like a SharePoint-hosted add-in would do when uploading files to the add-in web, or a solution that's running on the server would do when uploading files.
 
- **Note**  Provider-hosted add-ins written in JavaScript must use the SP.RequestExecutor cross-___domain library to send requests to a SharePoint ___domain. For an example, see  [upload a file by using the cross-___domain library](http://msdn.microsoft.com/library/2c3d2545-1cd7-497e-b535-12199d8edfbb%28Office.15%29.aspx#bk_FileCollectionAdd).
+> [!NOTE]
+> Provider-hosted add-ins written in JavaScript must use the SP.RequestExecutor cross-___domain library to send requests to a SharePoint ___domain. For an example, see  [upload a file by using the cross-___domain library](http://msdn.microsoft.com/library/2c3d2545-1cd7-497e-b535-12199d8edfbb%28Office.15%29.aspx#bk_FileCollectionAdd).
  
 To use the examples in this article, you'll need the following:
 
@@ -363,7 +364,7 @@ function onError(error) {
 }
 ```
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)

docs/apis/rest/use-odata-query-operations-in-sharepoint-rest-requests.md

@@ -20,7 +20,8 @@ The SharePoint REST service supports a wide range of OData query string operator
 ## Select fields to return
 Use the  [$select](http://www.odata.org/documentation/odata-version-2-0/uri-conventions#SelectSystemQueryOption) query option to specify which fields to return for a given list, list item, or other SharePoint object represented by an entity set. You can use `$select=*` to return all available fields.
 
- **Note**  In general, if you do not specify the  `$select` query option, the REST service returns all available fields by default. However, in a few cases, some SharePoint objects include properties that are very resource intensive to retrieve; to optimize REST service performance, these properties are not included in the default query, and must be explicitly requested.For example, the  **SPWeb.EffectiveBasePermissions** property is not returned by default, and must be explicitly requested using the `$select` query option.
+> [!NOTE]
+> In general, if you do not specify the  `$select` query option, the REST service returns all available fields by default. However, in a few cases, some SharePoint objects include properties that are very resource intensive to retrieve; to optimize REST service performance, these properties are not included in the default query, and must be explicitly requested.For example, the  **SPWeb.EffectiveBasePermissions** property is not returned by default, and must be explicitly requested using the `$select` query option.
  
 In addition, you can specify that the request returns projected fields from other lists and the values of lookups. To do this, specify the field name in both the  `$select` and `$expand` query options. For example:
 
@@ -37,7 +38,8 @@ Single value lookup fields are represented by two separate fields in the SharePo
 ## Query for users
 In the SharePoint REST service, users are represented by the user's friendly (display) name, and not their alias or ___domain\alias combination. Therefore, you must construct user queries against users' friendly names.
 
- **Note**  Membership-based user queries are not supported.Usage of the  **Current** operator to do queries using the ID of the current user is not supported.
+> [!NOTE]
+> Membership-based user queries are not supported.Usage of the  **Current** operator to do queries using the ID of the current user is not supported.
 
 ## Query for multi-value lookup fields and users
 Because multi-value lookup fields are returned as a string of multiple values, there is no way to query for them (for example, the equivalent of an  **Includes** element or **NotIncludes** element is not supported).
@@ -48,7 +50,8 @@ Use the  [$orderby](http://www.odata.org/documentation/odata-version-2-0/uri-con
 ## Page through returned items
 Use the  [$top](http://www.odata.org/documentation/odata-version-2-0/uri-conventions#TopSystemQueryOption) and [$skiptoken](http://msdn.microsoft.com/library/dd942121.aspx) query options to select a subset of the items that would otherwise be returned by your query.
 
- **Note**  The $skip query option does not work with queries for SharePoint list items.
+> [!NOTE]
+> The $skip query option does not work with queries for SharePoint list items.
 
 The  `$top` option enables you to select the first *n*  items of the return set for return. For example, the following URI requests that only the first ten items in the prospective return set actually be returned:
 
@@ -58,7 +61,8 @@ The $skiptoken option enables you to skip over items until the specified item is
 
  `$skiptoken=Paged=TRUE&p_ID=5`
 
- **Note**  When using these query options, take into account that paging in OData is ordinal. For example, suppose you are implementing a next page button to display SharePoint list items. You use the REST service to enable the button to return items 1 through 20 when clicked, then items 21 through 40, and so on. However, suppose another user deletes items 4 and 18 between clicks of the next button. In such a case, the ordinal positioning of the remaining items is reset, and displaying items 21 through 40 actually skips over two items.
+> [!NOTE]
+> When using these query options, take into account that paging in OData is ordinal. For example, suppose you are implementing a next page button to display SharePoint list items. You use the REST service to enable the button to return items 1 through 20 when clicked, then items 21 through 40, and so on. However, suppose another user deletes items 4 and 18 between clicks of the next button. In such a case, the ordinal positioning of the remaining items is reset, and displaying items 21 through 40 actually skips over two items.
  
 ## OData query operators supported in the SharePoint REST service
 <a name="bk_supported"> </a>
@@ -74,7 +78,7 @@ The figure below shows the supported OData query options.
 
 ![SharePoint REST service query option syntax](../../images/REST_queryOptionSyntax.png)
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)

docs/apis/rest/working-with-folders-and-files-with-rest.md

@@ -121,7 +121,8 @@ Headers:
 
 The following example shows how to  **update** a file by using the **PUT** method.
 
- **Note**   **PUT** is the only method that you can use to update a file. The **MERGE** method is not allowed.
+> [!NOTE]
+> **PUT** is the only method that you can use to update a file. The **MERGE** method is not allowed.
 
 ```
 url: http://site url/_api/web/GetFileByServerRelativeUrl('/Folder Name/file name')/$value
@@ -248,7 +249,8 @@ headers:
 
 The following example shows how to  **update** a file attachment to a list item by using the **PUT** method.
 
- **Note**   **PUT** is the only method that you can use to update a file. The **MERGE** method is not allowed.
+> [!NOTE]
+> **PUT** is the only method that you can use to update a file. The **MERGE** method is not allowed.
  
 ```
 url: http://site url/_api/web/lists/getbytitle('list title')/items(item id)/AttachmentFiles('file name')/$value
@@ -260,7 +262,7 @@ headers:
     X-RequestDigest: form digest value
     content-length:length of post body
 ```
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Complete basic operations using SharePoint REST endpoints](../../sp-add-ins/complete-basic-operations-using-sharepoint-rest-endpoints.md)

docs/apis/rest/working-with-lists-and-list-items-with-rest.md

@@ -25,7 +25,8 @@ Headers:
     accept: "application/json;odata=verbose" or "application/atom+xml"
 
 ```
- **Note**  Use  `application/json;odata=verbose` in the `accept` header if you want the response in JSON. Use `application/atom+xml` in the `accept` header if you want the response in Atom format.
+> [!NOTE]
+> Use  `application/json;odata=verbose` in the `accept` header if you want the response in JSON. Use `application/atom+xml` in the `accept` header if you want the response in Atom format.
  
 The following example shows how to  **retrieve** a specific list if you know its title.
 
@@ -82,7 +83,8 @@ The following XML shows an example of the list properties that are returned when
     </m:properties>
   </content>
 ```
- **Note**  The  **ListItemEntityTypeFullName** property ( **SP.Data.ProjectPolicyItemListItem** in the previous example) is especially important if you want to create and update list items. This value must be passed as the **type** property in the metadata that you pass in the body of the HTTP request whenever you create and update list items.
+> [!NOTE]
+> The  **ListItemEntityTypeFullName** property ( **SP.Data.ProjectPolicyItemListItem** in the previous example) is especially important if you want to create and update list items. This value must be passed as the **type** property in the metadata that you pass in the body of the HTTP request whenever you create and update list items.
 
 ## Working with lists by using REST
 <a name="WorkLists"> </a>
@@ -146,7 +148,8 @@ Headers:
 <a name="ListItems"> </a>
 The following example shows how to  **retrieve** all of a list's items.
 
- **Note**  The OData $skip query option does not work when querying list items. In may situations, you can use the  [$skiptoken](http://msdn.microsoft.com/library/4dda9434-c2c5-4577-8e01-7bf9e822d90a.aspx) option instead.
+> [!NOTE]
+> The OData $skip query option does not work when querying list items. In may situations, you can use the  [$skiptoken](http://msdn.microsoft.com/library/4dda9434-c2c5-4577-8e01-7bf9e822d90a.aspx) option instead.
 
 ```
 url: http://site url/_api/web/lists/GetByTitle('Test')/items
@@ -191,7 +194,8 @@ The following XML shows an example of the list item properties that are returned
 
 The following example shows how to  **create** a list item.
 
- **Note**  To do this operation, you must know the  **ListItemEntityTypeFullName** property of the list and pass that as the value of **type** in the HTTP request body.
+> [!NOTE]
+> To do this operation, you must know the  **ListItemEntityTypeFullName** property of the list and pass that as the value of **type** in the HTTP request body.
 
 ```
 url: http://site url/_api/web/lists/GetByTitle('Test')/items
@@ -207,7 +211,8 @@ headers:
 
 The following example shows how to  **update** a list item.
 
- **Note**  To do this operation, you must know the  **ListItemEntityTypeFullName** property of the list and pass that as the value of **type** in the HTTP request body.
+> [!NOTE]
+> To do this operation, you must know the  **ListItemEntityTypeFullName** property of the list and pass that as the value of **type** in the HTTP request body.
 
 ```
 url: http://site url/_api/web/lists/GetByTitle('Test')/items(item id)
@@ -248,7 +253,7 @@ If the  **ETag** you specify in your request does not match the **ETag** of the
 
 Within SharePoint, ETags apply only to SharePoint lists and list items.
 
-## Additional resources
+## See also
 <a name="bk_addresources"> </a>
 
 -  [Complete basic operations using SharePoint REST endpoints](complete-basic-operations-using-sharepoint-rest-endpoints.md)