MicrosoftDocs
diff --git a/‎appveyor.ps1
Lines changed: 35 additions & 1 deletion b/‎appveyor.ps1
Lines changed: 35 additions & 1 deletion
diff --git a/‎dsc/groupResource.md
Lines changed: 36 additions & 36 deletions b/‎dsc/groupResource.md
Lines changed: 36 additions & 36 deletions
@@ -7,14 +7,25 @@ param(
 $global:ProgressPreference = 'SilentlyContinue'
 if($ShowProgress){$ProgressPreference = 'Continue'}
 
+# Pandoc source URL
+$panDocVersion = "2.0.6"
+$pandocSourceURL = "https://github.com/jgm/pandoc/releases/download/$panDocVersion/pandoc-$panDocVersion-windows.zip"
+
+$pandocDestinationPath = New-Item (Join-Path ([System.IO.Path]::GetTempPath()) "PanDoc") -ItemType Directory -Force
+$pandocZipPath = Join-Path $pandocDestinationPath "pandoc-$panDocVersion-windows.zip"
+Invoke-WebRequest -Uri $pandocSourceURL -OutFile $pandocZipPath
+
+Expand-Archive -Path (Join-Path $pandocDestinationPath "pandoc-$panDocVersion-windows.zip") -DestinationPath $pandocDestinationPath -Force
+$pandocExePath = Join-Path (Join-Path $pandocDestinationPath "pandoc-$panDocVersion") "pandoc.exe"
+
 # Find the reference folder path w.r.t the script
 $ReferenceDocset = Join-Path $PSScriptRoot 'reference'
 
 # Variable to collect any errors in during processing
 $allErrors = @()
 
 # Go through all the directories in the reference folder
-Get-ChildItem $ReferenceDocset -Directory -Exclude 'docs-conceptual','mapping' | ForEach-Object -Process {
+Get-ChildItem $ReferenceDocset -Directory -Exclude 'docs-conceptual','mapping', 'bread-pscore' | ForEach-Object -Process {
     $Version = $_.Name
     $VersionFolder = $_.FullName
     # For each of the directories, go through each module folder
@@ -26,6 +37,29 @@ Get-ChildItem $ReferenceDocset -Directory -Exclude 'docs-conceptual','mapping' |
         $MamlOutputFolder = Join-Path "$PSScriptRoot\maml" "$Version\$ModuleName"
         $CabOutputFolder = Join-Path "$PSScriptRoot\updatablehelp" "$Version\$ModuleName"
 
+        # Process the about topics if any
+        $AboutFolder = Join-Path $ModulePath "About"
+
+        if(Test-Path $AboutFolder)
+        {
+            Get-ChildItem "$aboutfolder/about_*.md" | ForEach-Object {
+                $aboutFileFullName = $_.FullName
+                $aboutFileOutputName = "$($_.BaseName).help.txt"
+                $aboutFileOutputFullName = Join-Path $MamlOutputFolder $aboutFileOutputName
+
+                $pandocArgs = @(
+                    "--from=markdown",
+                    "--to=plain+multiline_tables+inline_code_attributes",
+                    "--columns=75",
+                    "--output=$aboutFileOutputFullName",
+                    $aboutFileFullName,
+                    "--quiet"
+                )
+
+                & $pandocExePath $pandocArgs
+            }
+        }
+
         try {
             # For each module, create a single maml help file
             # Adding warningaction=stop to throw errors for all warnings, erroraction=stop to make them terminating errors
 
@@ -1,6 +1,5 @@
 ---
 ms.date:  2017-06-12
-author:  eslesar
 ms.topic:  conceptual
 keywords:  dsc,powershell,configuration,setup
 title:  DSC Group Resource
 The Group resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage local groups on the target node.
 
 ## Syntax
+
 ```
 Group [string] #ResourceName
 {
@@ -29,20 +29,20 @@ Group [string] #ResourceName
 
 ## Properties
 
-|  Property  |  Description   | 
-|---|---| 
-| GroupName| The name of the group for which you want to ensure a specific state.| 
-| Credential| The credentials required to access remote resources. **Note**: This account must have the appropriate Active Directory permissions to add all non-local accounts to the group; otherwise, an error occurs when the configuration is executed on the target node.  
-| Description| The description of the group.| 
-| Ensure| Indicates if the group exists. Set this property to "Absent" to ensure that the group does not exist. Setting it to "Present" (the default value) ensures that the group exists.| 
-| Members| Use this property to replace the current group membership with the specified members. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use either the **MembersToExclude** or **MembersToInclude** property. Doing so generates an error.| 
-| MembersToExclude| Use this property to remove members from the existing membership of the group. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use the **Members** property. Doing so generates an error.| 
-| MembersToInclude| Use this property to add members to the existing membership of the group. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use the **Members** property. Doing so will generate an error.| 
-| DependsOn | Indicates that the configuration of another resource must run before this resource is configured. For example, if the ID of the resource configuration script block that you want to run first is __ResourceName__ and its type is __ResourceType__, the syntax for using this property is `DependsOn = "[ResourceType]ResourceName"``.| 
+|  Property  |  Description   |
+|---|---|
+| GroupName| The name of the group for which you want to ensure a specific state.|
+| Credential| The credentials required to access remote resources. **Note**: This account must have the appropriate Active Directory permissions to add all non-local accounts to the group; otherwise, an error occurs when the configuration is executed on the target node.
+| Description| The description of the group.|
+| Ensure| Indicates if the group exists. Set this property to "Absent" to ensure that the group does not exist. Setting it to "Present" (the default value) ensures that the group exists.|
+| Members| Use this property to replace the current group membership with the specified members. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use either the **MembersToExclude** or **MembersToInclude** property. Doing so generates an error.|
+| MembersToExclude| Use this property to remove members from the existing membership of the group. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use the **Members** property. Doing so generates an error.|
+| MembersToInclude| Use this property to add members to the existing membership of the group. The value of this property is an array of strings of the form *Domain*\\*UserName*. If you set this property in a configuration, do not use the **Members** property. Doing so will generate an error.|
+| DependsOn | Indicates that the configuration of another resource must run before this resource is configured. For example, if the ID of the resource configuration script block that you want to run first is __ResourceName__ and its type is __ResourceType__, the syntax for using this property is `DependsOn = "[ResourceType]ResourceName"``.|
 
 ## Example 1
 
-The following example shows how to ensure that a group called "TestGroup" is absent. 
+The following example shows how to ensure that a group called "TestGroup" is absent.
 
 ```powershell
 Group GroupExample
@@ -53,8 +53,12 @@ Group GroupExample
     GroupName = "TestGroup"
 }
 ```
+
 ## Example 2
-The following example shows how to add an Active Directory User to the local administrators group as part of a Multi-Machine Lab build where you are already using a PSCredential for the Local Adminstrator account. As this is also used for the Domain Admin Account (after Domain promotion) we then need to convert this existing PSCredential to a Domain Friendly credential to enable us to add a Domain User to the Local Administrators Group on the Member server.
+
+The following example shows how to add an Active Directory User to the local administrators group as part of a Multi-Machine Lab build where you are already using a PSCredential for the Local Adminstrator account.
+As this is also used for the Domain Admin Account (after Domain promotion), we then need to convert this existing PSCredential to a Domain Friendly credential.
+Then we can add a Domain User to the Local Administrators Group on the Member server.
 
 ```powershell
 @{
@@ -63,43 +67,39 @@ The following example shows how to add an Active Directory User to the local adm
             NodeName = '*';
             DomainName = 'SubTest.contoso.com';
          }
-     @{
+        @{
             NodeName = 'Box2';
-            AdminAccount = 'Admin-Dave_Alexanderson'   
-      }    
+            AdminAccount = 'Admin-Dave_Alexanderson'
+        }
     )
 }
-                  
+
 $domain = $node.DomainName.split('.')[0]
 $DCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList ("$domain\$($credential.Username)", $Credential.Password)
 
-Group AddADUserToLocalAdminGroup
-        {
-            GroupName='Administrators'   
-            Ensure= 'Present'             
-            MembersToInclude= "$domain\$($Node.AdminAccount)"
-            Credential = $dCredential    
-            PsDscRunAsCredential = $DCredential
-        }
+Group AddADUserToLocalAdminGroup {
+    GroupName='Administrators'
+    Ensure= 'Present'
+    MembersToInclude= "$domain\$($Node.AdminAccount)"
+    Credential = $dCredential
+    PsDscRunAsCredential = $DCredential
+}
 ```
 
 ## Example 3
-The following example shows how to ensure a local group, TigerTeamAdmins, on the server TigerTeamSource.Contoso.Com does not contain a particular domain account, Contoso\JerryG.  
 
-```powershell
+The following example shows how to ensure a local group, TigerTeamAdmins, on the server TigerTeamSource.Contoso.Com does not contain a particular domain account, Contoso\JerryG.
 
-Configuration SecureTigerTeamSrouce 
-{
+```powershell
+Configuration SecureTigerTeamSrouce {
   Import-DscResource -ModuleName 'PSDesiredStateConfiguration'
-  
+
   Node TigerTeamSource.Contoso.Com {
-  Group TigerTeamAdmins
-    {
-       GroupName        = 'TigerTeamAdmins'   
-       Ensure           = 'Absent'             
-       MembersToInclude = "Contoso\JerryG"
+    Group TigerTeamAdmins {
+       GroupName        = 'TigerTeamAdmins'
+       Ensure           = 'Present'
+       MembersToExclude = "Contoso\JerryG"
     }
   }
 }
 ```
-