Update site-design-overview.md

Updates for spring release in progress. Do not publish to live branch until after 4/9 (confirm w/ Sean and Vesa)

Author: seansquires

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

@@ -1,7 +1,7 @@
----
+--
 title: SharePoint site design and site script overview
 description: Use SharePoint site scripts and site designs to automate provisioning new SharePoint sites with custom configurations.
-ms.date: 01/08/2018
+ms.date: 04/08/2018
 ---
 
 # SharePoint site design and site script overview
@@ -13,7 +13,7 @@ Use site designs and site scripts to automate provisioning new or existing moder
 
 ## How site designs work
 
-Site designs are like a template. They can be used each time a new site is created to apply a consistent set of actions. They can also be applied to existing modern sites (Group-connected Team and communication). Most actions typically affect the site itself, such as setting the theme, or creating lists. But a site design can also include other actions, such as recording the new site URL to a log, or sending a tweet.
+Site designs are like a template. They can be used each time a new site is created to apply a consistent set of actions. They can also be applied to existing modern sites (Group-connected Team and Communication). Most actions typically affect the site itself, such as setting the theme, or creating lists. But a site design can also include other actions, such as recording the new site URL to a log, or sending a tweet.
 
 You create site designs and register them in SharePoint to one of the modern template sites: the team site, or communication site. You can see how this works in the following steps.
 
@@ -94,7 +94,6 @@ Site scripts are JSON files that specify an ordered list of actions to run when
       ]
     }
   ],
-  "bindata": { },
   "version": 1
 }
 ```
@@ -103,17 +102,25 @@ Each action in a site script is specified by a **verb** value in the JSON. In th
 
 Available actions include:
 
-- Creating a new list
+- Creating a new list or library (or modifying the default one created with the site)
+- Creating site columns, content types, and configuring other list settings
 - Applying a theme
 - Setting a site logo
 - Adding navigation
-- Triggering a Microsoft flow
+- Triggering a Microsoft Flow
+- Installing a deployed solution from the app catalog
+- Setting regional settings for the site
+- Setting external sharing capability for the site
+
+For a complete list of available actions and their parameters, check out the JSON schema: https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-json-schema
 
-Site scripts can be run again on the same site after provisioning. This can only be done programmatically. Site scripts are non-destructive, so when they run again, they ensure that the site matches the configuration in the script. For example, if the site already has a list with the same name that the site script is creating, the site script will only add missing fields to the existing list. Also, please note that site scripts are limited to 30 cumulative actions (across one or more scripts that may be called in a site design).
+Site scripts can be run again on the same site after provisioning. This can only be done programmatically. Site scripts are non-destructive, so when they run again, they ensure that the site matches the configuration in the script. For example, if the site already has a list with the same name that the site script is creating, the site script will only add missing fields to the existing list. Also, please note that site scripts are limited to 30 cumulative actions (across one or more scripts that may be called in a site design). This includes subactions.
 
 ## Using PowerShell or REST to work with site designs and site scripts
 
-You can create site designs and site scripts by using PowerShell, or the REST API. The following example creates a site script and a site design that uses the site script. <!-- The PowerShell example loads the script from a file, while the REST example has the script inline. -->
+You can create site designs and site scripts by using PowerShell, or the REST API. The following example creates a site script and a site design that uses the site script. 
+
+<!-- The PowerShell example loads the script from a file, while the REST example has the script inline. -->
 
 ```powershell
 C:\> Get-Content 'c:\scripts\site-script.json' `
@@ -194,6 +201,7 @@ RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.SiteScri
    }
   });
 ```
+
 -->
 
 In the previous example, the **Add-SPOSiteScript** cmdlet, or **CreateSiteScript** REST API returns a site script id. This is used for the **SiteScripts** parameter in the subsequent call to the **Add-SPO-SiteDesign** cmdlet, or **CreateSiteDesign** REST API.