authored customizing default site designs

Author: davidchesnut

docs/declarative-customization/customize-default-site-design.md

@@ -0,0 +1,56 @@
+---
+title: Customize default site designs on SharePoint
+description: Customize the default site designs in either the SharePoint team site or communications site template
+ms.date: 12/18/2017
+---
+
+# Customize a default site design
+
+> [!NOTE]
+> Site designs and site scripts are currently in preview and are subject to change. They are not currently supported for use in production environments.
+
+SharePoint contains several site designs already available in the SharePoint Online site templates. These are the default site designs. You can modify them using PowerShell or the REST APIs to control the entire site provisioning experience. For example, you can ensure that your company theme is applied to every site that gets created. Or you can make sure a logging mechanism always runs regardless of which site design is chosen.
+
+## Apply a site design to the default site designs
+
+To customize the default site designs, apply a new one with the Powershell **Add-SPOSiteDesign** cmdlet, or the **CreateSiteDesign** REST API. Specify the **IsDefault** switch to apply the site design as default.
+
+The following example shows how to use the **IsDefault** switch to apply the Contoso company theme to the default site designs. The site script referenced by ID contains the JSON script to apply the correct theme.
+
+```powershell
+C:\> Add-SPOSiteDesign `
+  -Title "Contoso company theme" `
+  -WebTemplate "68" `
+  -SiteScripts "89516c6d-9f4d-4a57-ae79-36b0c95a817b" `
+  -Description "Applies standard company theme to site" `
+  -IsDefault
+```
+```javascript
+RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.SiteScriptUtility.CreateSiteDesign", {info:{Title:"Contoso company theme", Description:"Applies standard company theme to site", SiteScriptIds:["89516c6d-9f4d-4a57-ae79-36b0c95a817b"],  WebTemplate:"68", IsDefault: true}});
+```
+
+## Which default site designs are updated?
+
+In the previous example, the **WebTemplate** value of "68" refers to the SharePoint Online communication site template. That template contains the following default site designs:
+
+- Topic
+- Showcase
+- Blank
+
+When you apply a new site design, it will update all three of the default site designs at the same time.
+
+The SharePoint Online team site template contains only one default site design named **Team**. In this case when you apply a default site design, only the **Team** site design is updated.
+
+## Restoring the default site designs
+
+To restore a site design to the defaults, remove the site design you applied. In the previous example, if the site design created had the ID db752673-18fd-44db-865a-aa3e0b28698e, you would remove it as shown in the following example.
+
+```powershell
+C:\> Remove-SPOSiteDesign db752673-18fd-44db-865a-aa3e0b28698e
+```
+```javascript
+RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.SiteScriptUtility.DeleteSiteDesign", {id:"db752673-18fd-44db-865a-aa3e0b28698e"});
+```
+
+> [!NOTE]
+> If you're not sure which site design is the default, run the **Get-SPOSiteDesign** cmdlet. It will list all site designs, and indicates which ones are defaults.

docs/declarative-customization/site-design-apply-default-template.md

@@ -34,7 +34,7 @@ These are the default site designs. For each site design there is a title, descr
 
 ![Default site design title, description, and image on communication site template](images/site-designs-listed-on-communication-site-template.png)
 
-Had you chosen the team site template, it contains only one default site design named **Team site**. <!-- For additional information on how you can change the default site designs, see [Applying a site design to a default SharePoint template](site-design-apply-default-template.md). -->
+Had you chosen the team site template, it contains only one default site design named **Team site**. For additional information on how you can change the default site designs, see [Applying a site design to a default SharePoint template](customize-default-site-design.md).
 
 Once a site design is selected, SharePoint creates the new site, and runs site scripts for the site design. The site scripts detail the work such as creating new lists, or applying a theme. When the actions in the scripts are completed, SharePoint displays detailed results of those actions in a progress pane.
 

docs/declarative-customization/site-design-overview.md

@@ -78,8 +78,7 @@ C:\> Add-SPOSiteDesign `
   -SiteScripts "<ID>" `
   -Description "Tracks key customer data in a list" `
   -PreviewImageUrl "https://contoso.sharepoint.com/SiteAssets/site-preview.png" `
-  -PreviewImageAltText "site preview" `
-  -IsDefault $false
+  -PreviewImageAltText "site preview"
 ```
 
 ## **Add-SPOSiteScript**