synced 1.3 release updates

Author: davidchesnut

Microsoft Sharepoint Framework Preview EULA.DOCX

@@ -0,0 +1,100 @@
+# Creating SharePoint Communication Site using REST
+
+Learn how to create and get the status of a new modern SharePoint Communication site with the REST interface.
+
+## Prerequisites
+
+This topic assumes that you are already familiar with the topics Get to know the SharePoint REST service and Complete basic operations using SharePoint REST endpoints. It does not provide code snippets.
+
+The following REST commands are available for creating a modern SharePoint Communication site.
+
+- **Create** - Create a new SharePoint Communication site
+- **Status** - Get the status of a SharePoint Communication site
+
+The URL for communication site REST commands is based on `_api/sitepages/communicationsite`. For example, these are the endpoints for the commands listed above:
+
+- `http:///_api/sitepages/communicationsite/create`
+- `http:///_api/sitepages/communicationsite/status`
+
+## Create Communication Site
+
+```
+url: /_api/sitepages/communicationsite/create
+method: POST
+body:
+{
+  "__metadata":{"type":"SP.Publishing.CommunicationSiteCreationRequest"},
+  "AllowFileSharingForGuestUsers":false,
+  "Classification":"Contoso confidential",
+  "Description":"Here is my communication site",
+  "SiteDesignId":"6142d2a0-63a5-4ba0-aede-d9fefca2c767",
+  "Title":"comm1",
+  "Url":"https://contoso.sharepoint.com/sites/comm1",
+  "lcid":1033
+}
+```
+
+Note: New in this API is the concept of SiteDesignID. Much like the in-product site creation flow, the SiteDesignID parameter maps to the included site designs. They are:
+
+- Topic: null
+- Showcase: 6142d2a0-63a5-4ba0-aede-d9fefca2c767
+- Blank: f6cc5403-0d63-442e-96c0-285923709ffc
+
+**Response**
+
+If successful, this method returns 200, OK response code and simple JSON object in the response body with following details.
+
+```
+{
+  "d":{
+      "Create":{
+           "__metadata":{"type":"SP.Publishing.CommunicationSiteCreationResponse"},
+          "SiteStatus":2,
+          "SiteUrl":"https://contoso.sharepoint.com/sites/comm1"
+      }
+  }
+}
+```
+
+
+## Get Communication Site Status
+
+REST API for getting the status of a modern SharePoint Communication site
+
+```
+url: /_api/sitepages/communicationsite/status?url='https%3A%2F%2Fcontoso.sharepoint.com%2Fsites%2Fcomm1'
+method: GET
+body: none
+```
+
+**Response**
+
+If successful, this method returns 200, OK response code and simple JSON object in the response body with following details.
+ 
+If the site exists, the response will return the site status and site URL.
+
+```
+{
+  "d":{
+      "Status":{
+           "__metadata":{"type":"SP.Publishing.CommunicationSiteCreationResponse"},
+          "SiteStatus":2,
+          "SiteUrl":"https://contoso.sharepoint.com/sites/comm1"
+      }
+  }
+}
+```
+
+If the site does not exist, the response will return site status of 0 with no URL.
+
+```
+{
+  "d":{
+      "Status":{
+           "__metadata":{"type":"SP.Publishing.CommunicationSiteCreationResponse"},
+          "SiteStatus":0,
+          "SiteUrl":
+      }
+  }
+}
+```

docs/apis/communication-site-creation-rest.md

@@ -10,7 +10,8 @@ Learn how to define custom, fine-grained permissions on a SharePoint list by usi
 
 SharePoint sites, lists, and list items are types of  **SecurableObject**. By default, a securable object inherits the permissions of its parent. To set custom permissions for an object, you need to break its inheritance so that it stops inheriting permissions from its parent, and then define new permissions by adding or removing role assignments.
 
- **Note**  See  [Additional resources](set-custom-permissions-on-a-list-by-using-the-rest-interface.md#bk_addresources) for links to articles about setting fine-grained permissions.
+> [!Note]
+> See [Additional resources](set-custom-permissions-on-a-list-by-using-the-rest-interface.md#bk_addresources) for links to articles about setting fine-grained permissions.
  
 The code example in this article sets custom permissions on a list, and then changes a group's permissions to it. The example uses the REST interface to:
 

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

@@ -0,0 +1,172 @@
+# SharePoint site theming: CSOM development
+
+The SharePoint Client Side Object Model (CSOM) provides .NET developers with access to the SharePoint object model from code that is running locally or on a different server than SharePoint. This topic covers the site theming functionality available in CSOM.
+
+## Prerequisites
+This topic assumes you are familiar with the topics [Using the Client Object Model](https://msdn.microsoft.com/en-us/library/ff798388.aspx) and [Common Programming Tasks in the Managed Client Object Model](https://msdn.microsoft.com/en-us/library/ee537013.aspx), which cover how to work with the SharePoint CSOM.
+
+Install the following components for CSOM development:
+
+* [SharePoint Server 2016 Client Component SDK](https://www.microsoft.com/en-us/download/details.aspx?id=51679)
+* [Microsoft.SharePointOnline.CSOM](https://www.nuget.org/packages/Microsoft.SharePointOnline.CSOM/) NuGet package (version 16.1.6906.1200 or later)
+
+## Sample code
+
+The following sample shows how to create a __Microsoft.Online.SharePoint.TenantAdministration.Tenant__ object and call the __GetAllTenantThemes__ method to return a list of themes. Notes on this sample:
+
+* The URL used for creating the context object includes the _-admin_ suffix, because TenantAdministration methods work with the admin site.
+* Create a __Tenant__ instance with the [Tenant constructor](https://msdn.microsoft.com/en-us/library/dn174852.aspx), and then call the methods on that instance.
+* The same approach can be used for calling other theme management methods.
+
+```C#
+using System.Security;
+using SPClient=Microsoft.SharePoint.Client;
+using Microsoft.Online.SharePoint.TenantAdministration;
+using Microsoft.Online.SharePoint.TenantManagement;
+
+SPClient.ClientContext ctx = new SPClient.ClientContext("https://mysite-admin.sharepoint.com/");
+var pwd = "mypassword";
+var passWord = new SecureString();
+foreach (char c in pwd.ToCharArray()) passWord.AppendChar(c);
+ctx.Credentials = new SPClient.SharePointOnlineCredentials("[email protected]", passWord);
+Tenant tenant = new Tenant(ctx);
+SPClient.ClientObjectList<ThemeProperties> themes = tenant.GetAllTenantThemes();
+```
+
+## Sample theme definition
+
+For methods that take a theme argument, the following code defines an __SPOTheme__ class that you can use to create custom themes.
+
+```C#
+/// <summary> 
+/// Properties defining a theme in SharePoint Online. 
+/// </summary> 
+public class SPOTheme 
+{ 
+    /// <summary> 
+    /// Specifies the name of the theme. This must uniquely identify the theme. 
+    /// </summary> 
+    public string Name 
+    { 
+        get; private set; 
+    } 
+    /// <summary> 
+    /// Specifies the palette of colors in the theme, as a dictionary of theme slot values. 
+    /// </summary> 
+    public IDictionary<String, String> Palette 
+    { 
+        get; private set; 
+    } 
+    /// <summary> 
+    /// Specifies whether the theme is inverted, with a dark background and a light foreground. 
+    /// </summary> 
+    public bool IsInverted 
+    { 
+        get; private set; 
+    } 
+} 
+```
+
+## Applying a theme
+
+The methods covered below are used to manage the available themes in your tenant. To _apply_ a theme to a particular SharePoint web site, use the [SPWeb.ApplyTheme](https://msdn.microsoft.com/en-us/library/office/jj251358.aspx) method of the [Microsoft.SharePoint.Client.Web](https://msdn.microsoft.com/en-us/library/office/microsoft.sharepoint.client.web.aspx) class.
+
+## Methods/properties of the Microsoft.Online.SharePoint.TenantAdministration.Tenant class
+
+These methods can be used to customize a SharePoint tenant administration site's set of available themes. You can add a new custom theme, update an existing theme, or delete a theme, and you can retrieve a specific theme or all themes. You can also hide or restore the default themes that come with SharePoint.
+
+### AddTenantTheme public method
+Add a theme to the tenant.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name, string themeJson<br/>
+__Return type:__ ClientResult<bool>
+
+### DeleteTenantTheme public method
+Delete a theme from the tenant.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name<br/>
+__Return type:__ void
+
+### GetAllTenantThemes public method
+Retrieve all of the themes currently available in the tenant, including any custom themes that have been added. Default themes are only included if the __HideDefaultThemes__ property is __false__ (the default value).
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ none<br/>
+__Return type:__ ClientObjectList<ThemeProperties>
+
+### GetTenantTheme public method
+Retrieve a theme by name.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name<br/>
+__Return type:__ ThemeProperties
+
+### HideDefaultThemes public property
+This property indicates whether the default themes ("out of the box" themes) are hidden in the theme picker user interface for modern pages. You might want to set this property to __true__ after defining custom themes, to allow only specific themes to be used.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Type:__ Boolean
+
+### UpdateTenantTheme public method
+Update the settings for an existing theme.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name, string themeJson<br/>
+__Return type:__ ClientResult<bool>
+
+## Methods of the Microsoft.Online.SharePoint.TenantManagement.Tenant class
+
+These methods can be used to manage themes in a multi-tenant environment.
+
+### AddTenantTheme public method
+Add a theme to the tenant.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ string name, string themeJson<br/>
+__Return type:__ ClientResult<bool>
+
+### GetAllTenantThemes public method
+Retrieve all of the themes currently available in the tenant, including any custom themes that have been added. Default themes are only included if the __HideDefaultThemes__ property is __false__ (the default value).
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ none<br/>
+__Return type:__ ClientObjectList<ThemeProperties>
+
+### GetHideDefaultThemes public method
+Read the current setting for whether to hide default themes in the theme picker user interface.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ none<br/>
+__Return type:__ ClientResult<bool>
+
+### GetTenantTheme public method
+Retrieve a theme by name.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ string name<br/>
+__Return type:__ ThemeProperties
+
+### SetHideDefaultThemes public method
+Specify whether to hide default themes in the theme picker user interface.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ Boolean<br/>
+__Return type:__ void
+
+### UpdateTenantTheme public method
+Update the settings for an existing theme.
+
+__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Parameters:__ string name, string themeJson<br/>
+__Return type:__ ClientResult<bool>
+
+## Additional resources
+
+* [SharePoint site theming overview](sharepoint-site-theming-overview.md)
+* [SharePoint site theming: JSON schema](sharepoint-site-theming-json-schema.md)
+* [SharePoint site theming: PowerShell commands](sharepoint-site-theming-powershell.md)
+* [SharePoint site theming: REST API](sharepoint-site-theming-rest-api.md)
+* [Using the Client Object Model](https://msdn.microsoft.com/en-us/library/ff798388.aspx)
+* [Common Programming Tasks in the Managed Client Object Model](https://msdn.microsoft.com/en-us/library/ee537013.aspx)