Bobbytreed issue3571 (#3780)

* Fixes #3618, Fixes #3571 - Add enumerator content to automatic variables

* Stashing changes

* Stashing changes

* synchronizing versions

* Updating style

* Updating date

* Update about_Automatic_Variables.md

Author: bobbytreed

reference/3.0/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,31 +1,30 @@
----
-ms.date:  11/28/2017
+---
+md.date: 2/27/2019
 schema:  2.0.0
 locale:  en-us
 keywords:  powershell,cmdlet
 title:  about_Foreach
 ---
 # About ForEach
 
-## SHORT DESCRIPTION
-
+## Short description
 Describes a language command you can use to traverse all the items in a
 collection of items.
 
-## LONG DESCRIPTION
+## Long description
 
-The Foreach statement (also known as a Foreach loop) is a language construct
+The `Foreach` statement (also known as a `Foreach` loop) is a language construct
 for stepping through (iterating) a series of values in a collection of items.
 
 The simplest and most typical type of collection to traverse is an array.
-Within a Foreach loop, it is common to run one or more commands against each
+Within a `Foreach` loop, it is common to run one or more commands against each
 item in an array.
 
 ## Syntax
 
-The following shows the ForEach syntax:
+The following shows the `ForEach` syntax:
 
-```syntax
+```
 foreach ($<item> in $<collection>){<statement list>}
 ```
 
@@ -54,7 +53,7 @@ string values `"a"`, `"b"`, `"c"`, and `"d"`. The first time the `Foreach`
 statement runs, it sets the `$letter` variable equal to the first item in
 `$letterArray` (`"a"`). Then, it uses the `Write-Host` cmdlet to display the
 letter a. The next time through the loop, `$letter` is set to `"b"`, and so
-on. After the `Foreach` loop displays the letter d, Windows PowerShell exits
+on. After the `Foreach` loop displays the letter d, PowerShell exits
 the loop.
 
 The entire `Foreach` statement must appear on a single line to run it as a
@@ -158,6 +157,8 @@ variable inside of a foreach script block. The example function can find
 functions in a script even if there are unusually- or inconsistently-spaced
 function definitions that span multiple lines.
 
+For more information, see [Using Enumerators](about_Automatic_Variables.md#using-enumerators).
+
 ```powershell
 function Get-FunctionPosition {
   [CmdletBinding()]
@@ -226,4 +227,4 @@ function Get-FunctionPosition {
 
 [about_If](about_If.md)
 
-[ForEach-Object](../ForEach-Object.md)
+[ForEach-Object](../ForEach-Object.md)