Merge pull request #1 from PowerShell/staging

Syncing from original

Author: arestarh

STYLE.md

@@ -35,9 +35,21 @@ Header 2
 ## Syntax
 
 * When talking about a cmdlet in paragraph, use \` to highlight cmdlet names
-  * When writing an article (as opposed to reference content), the first instance of a cmdlet name should be a link to the cmdlet documentation
+  * Correct Example:
+  This `Write-Host` Cmdlet can ...
+  * Incorrect Example:
+  This **Write-Host** Cmdlet can ... and pipeline to out-file Cmdlet to ...
+* When writing an article (as opposed to reference content), the first instance of a cmdlet name should be a link to the cmdlet documentation
 * All PowerShell syntax blocks should use ```powershell
-* Do not start PowerShell commands with "C:\ PS>"
+* Do not start PowerShell commands with "`PS C:\>`"
+  * Correct Example:
+  ```powershell
+  Get-Process
+  ```
+  * Incorrect Example:
+  ```powershell
+  PS C:\> Get-Process
+  ```
 * Output emitted by PowerShell commands should be commented to prevent it from recieving syntax highlighting
 * Property names and parameter names should be in **bold**
 * PowerShell cmdlets are "[Pascal Cased](https://en.wikipedia.org/wiki/PascalCase)". Verbs are seperated from nouns by a hyphen.

dsc/DSCAutomationHostEnabled.md

@@ -1,13 +1,9 @@
-
 ---
-title:   DSCAutomationHostEnabled registry key
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSCAutomationHostEnabled registry key
 ---
 
 >Applies to: Windows PowerShell 5.0

dsc/DscForEngineers.md

@@ -1,12 +1,9 @@
 ---
-title:   Desired State Configuration Overview for Decision Makers 
-ms.date:  2017-03-13
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  carmonm
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Desired State Configuration Overview for Decision Makers
 ---
 
 # Desired State Configuration Overview for Engineers #
@@ -141,3 +138,4 @@ To deploy to the different environments, you can invoke `Start-DscConfiguration`
 [Configuration Data](configData.md)
 
 [Resources](resources.md)
+

dsc/PackageManagementDscResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC PackageManagement Resource
-ms.date:  
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
-author:  brywang-msft
-manager:  kriscv
-ms.prod:  powershell
+ms.date:  2017-06-12
+author:  eslesar
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC PackageManagement Resource
 ---
 
 # DSC PackageManagement Resource
@@ -94,4 +91,5 @@ Configuration PackageTest
 		DependsOn            = "[PackageManagementSource]PSGallery" 
     }
 }
-```
+```
+

dsc/PackageManagementSourceDscResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC PackageManagementSource Resource
-ms.date:  
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
-author:  brywang-msft
-manager:  kriscv
-ms.prod:  powershell
+ms.date:  2017-06-12
+author:  eslesar
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC PackageManagementSource Resource
 ---
 
 # DSC PackageManagementSource Resource
@@ -56,3 +53,4 @@ Configuration PackageManagementSourceTest
 	}
 }
 ```
+

dsc/archiveResource.md

@@ -1,12 +1,9 @@
 ---
-title:   DSC Archive Resource
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  DSC Archive Resource
 ---
 
 # DSC Archive Resource

dsc/authoringResource.md

@@ -1,12 +1,9 @@
 ---
-title:   Build Custom Windows PowerShell Desired State Configuration Resources
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Build Custom Windows PowerShell Desired State Configuration Resources
 ---
 
 # Build Custom Windows PowerShell Desired State Configuration Resources

dsc/authoringResourceClass.md

@@ -1,12 +1,9 @@
 ---
-title:   Writing a custom DSC resource with PowerShell classes
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Writing a custom DSC resource with PowerShell classes
 ---
 
 # Writing a custom DSC resource with PowerShell classes

dsc/authoringResourceComposite.md

@@ -1,12 +1,9 @@
 ---
-title:   Composite resources--Using a DSC configuration as a resource
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Composite resources--Using a DSC configuration as a resource
 ---
 
 # Composite resources: Using a DSC configuration as a resource

dsc/authoringResourceMOF.md

@@ -1,12 +1,9 @@
 ---
-title:   Writing a custom DSC resource with MOF
-ms.date:  2016-05-16
-keywords:  powershell,DSC
-description:  
-ms.topic:  article
+ms.date:  2017-06-12
 author:  eslesar
-manager:  dongill
-ms.prod:  powershell
+ms.topic:  conceptual
+keywords:  dsc,powershell,configuration,setup
+title:  Writing a custom DSC resource with MOF
 ---
 
 # Writing a custom DSC resource with MOF