Updates to Features section, part 2 (SharePoint#1722)

* Updates to Groupify topics

* Edit pass

* Edit pass on Hub sites

* Edit pass on REST API

* Edit pass on REST API

* updated date

* Fixed TOC

* Attempt to publish to branch

* Edit pass on Decl-Cust section

* Edit pass of site design

* Adjusted spacing

* Trying to push queue out

Author: Linda-Editor

docs/apis/alm-api-for-spfx-add-ins.md

@@ -8,7 +8,7 @@ ms.assetid: fdf7ecb2-8851-425b-b058-3285fba77b68
 
 # Application Lifecycle Management (ALM) APIs
 
-ALM APIs provide simple APIs to manage deployment of your SharePoint Framework solutions and add-ins across your tenant. ALM APIs support the following capabilities:
+ALM APIs provide simple APIs to manage deployment of your SharePoint Framework solutions and add-ins across your tenant. ALM APIs support the following capabilities: 
 
 - Add SharePoint Framework solution or SharePoint Add-in to tenant or site collection app catalog.
 - Remove SharePoint Framework solution or SharePoint Add-in from tenant or site collection app catalog.

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

@@ -7,7 +7,7 @@ ms.prod: sharepoint
 
 # Create SharePoint Communication site using REST
 
-This topic assumes that you are already familiar with the following topics:
+This topic assumes that you are already familiar with the following topics: 
 
 - [Get to know the SharePoint REST service](../sp-add-ins/get-to-know-the-sharepoint-rest-service.md)
 - [Complete basic operations using SharePoint REST endpoints](../sp-add-ins/complete-basic-operations-using-sharepoint-rest-endpoints.md)

docs/community/open-source-projects.md

@@ -26,7 +26,7 @@ There are numerous open-source projects that are coordinated by the SharePoint P
 
 ## Supportability of open-source projects
 
-The following statements apply across all of the SharePoint development (PnP) samples, reusable solutions, controls, and core components, and even the more polished solutions, such as the GDPR Activity Hub or the PnP Provisioning Engine:
+The following statements apply across all of the SharePoint development (PnP) samples, reusable solutions, controls, and core components, and even the more polished solutions, such as the GDPR Activity Hub or the PnP provisioning engine:
 
 * PnP guidance and samples are created by Microsoft and the community.
 * PnP guidance and samples are maintained by Microsoft and the community.

docs/community/repositories.md

@@ -39,7 +39,7 @@ There are numerous SharePoint Developer GitHub repositories, which all have diff
 | [pnp](https://github.com/SharePoint/pnp) | Main repository for SharePoint Add-ins, Microsoft Graph, and other samples |
 | [pnp-sites-core](https://github.com/SharePoint/pnp-sites-core) | Office Dev PnP CSOM Core component - Extension component for native SharePoint Client-Side Object Model |
 | [pnp-powershell](https://github.com/SharePoint/pnp-powershell) | Source code for [SharePoint PnP PowerShell cmdlets](https://docs.microsoft.com/en-us/powershell/sharepoint/sharepoint-pnp/sharepoint-pnp-cmdlets?view=sharepoint-ps) |
-| [pnp-provisioning-schema](https://github.com/SharePoint/PnP-Provisioning-Schema) | PnP Provisioning engine schema repository |
+| [pnp-provisioning-schema](https://github.com/SharePoint/PnP-Provisioning-Schema) | PnP provisioning engine schema repository |
 | [pnp-tools](https://github.com/SharePoint/PnP-Tools) | Repository for tools and scripts targeted primarily for IT pros and for on-premises SharePoint 2013 and SharePoint 2016 |
 | [pnp-partner-pack](https://github.com/SharePoint/PnP-Partner-Pack) | Packaged guidance with detailed instructions about setting things up in Office 365 and Azure |
 | [pnp-js-core](https://github.com/SharePoint/PnP-JS-Core) | Office Dev PnP Core component for JavaScript |

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

@@ -1,18 +1,18 @@
 ---
-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
+title: Customize default site designs in SharePoint
+description: Customize the default site designs in either the SharePoint Team site or Communication site template.
+ms.date: 04/20/2018
 ---
 
 # Customize a default site design
 
-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.
+SharePoint contains several site designs already available in the SharePoint Online site templates. These are the default site designs. You can modify them by 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. 
+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 the default. 
 
-The WebTemplate ID for a Group-connected team site is 64; for a communication site it is 68.
+The WebTemplate ID for a group-connected Team site is 64; for a Communication site it is 68.
 
 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.
 
@@ -24,32 +24,42 @@ C:\> Add-SPOSiteDesign `
   -Description "Applies standard company theme to site" `
   -IsDefault
 ```
+
+<br/>
+
 ```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?
+### 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:
+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.
+When you apply a new site design, it updates all three 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.
+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
+## Restore 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.
+To restore a site design to the defaults, remove the site design that 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
 ```
+
+<br/>
+
 ```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.
+
+## See also
+
+- [SharePoint site design and site script overview](site-design-overview.md)