Merge pull request #2532 from LizCasey/v-elicas071718

Content fixes for VS extensibility-debugger articles, Task 1303377.

Author: rmca14

docs/extensibility/debugger/asynctaskmethodbuilder-m-builder-field.md

@@ -14,7 +14,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder.m_builder Field
+# AsyncTaskMethodBuilder.m_builder field
 Represents the generic builder object to which this non-generic instance delegates.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -25,12 +25,12 @@ Represents the generic builder object to which this non-generic instance delegat
 
 ## Syntax  
 
-```  
+```csharp 
 .field private valuetype System.Runtime.CompilerServices.AsyncTaskMethodBuilder`1<valuetype System.Threading.Tasks.VoidTaskResult> m_builder  
 ```  
 
 ## Remarks  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asynctaskmethodbuilder-objectidfordebugger-property.md

@@ -14,7 +14,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder.ObjectIdForDebugger Property
+# AsyncTaskMethodBuilder.ObjectIdForDebugger property
 Gets an object that may be used to uniquely identify this builder to the debugger.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -29,6 +29,6 @@ Gets an object that may be used to uniquely identify this builder to the debugge
 private object ObjectIdForDebugger  
 ```  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asynctaskmethodbuilder-structure-internal-members.md

@@ -15,7 +15,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder Structure - Internal Members
+# AsyncTaskMethodBuilder structure - internal members
 This topic describes the internal members of the <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder> class. For general information about this class, see the <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder> reference topic.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -26,19 +26,19 @@ This topic describes the internal members of the <xref:System.Runtime.CompilerSe
 
 ## Syntax  
 
-```  
+```csharp  
 .class public sequential ansi sealed beforefieldinit System.Runtime.CompilerServices.AsyncTaskMethodBuilder  
        extends System.ValueType  
        implements System.Runtime.CompilerServices.IAsyncMethodBuilder  
 ```  
 
-## Internal Members  
+## Internal members  
 
 |Name|Description|  
 |----------|-----------------|  
 |[ObjectIdForDebugger property](../../extensibility/debugger/asynctaskmethodbuilder-objectidfordebugger-property.md)|Gets an object that may be used to uniquely identify this builder to the debugger.|  
 |[m_builder field](../../extensibility/debugger/asynctaskmethodbuilder-m-builder-field.md)|Represents the generic builder object to which this non-generic instance delegates.|  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asynctaskmethodbuilder-tresult-m-task-field.md

@@ -14,7 +14,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder<TResult>.m_task Field
+# AsyncTaskMethodBuilder<TResult>.m_task field
 Represents the lazily initialized built task.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -25,10 +25,10 @@ Represents the lazily initialized built task.
 
 ## Syntax  
 
-```  
+```csharp  
 .field private class System.Threading.Tasks.Task`1<!TResult> m_task  
 ```  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asynctaskmethodbuilder-tresult-objectidfordebugger-property.md

@@ -14,7 +14,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder<TResult>.ObjectIdForDebugger Property
+# AsyncTaskMethodBuilder<TResult>.ObjectIdForDebugger property
 Gets an object that may be used to uniquely identify this builder to the debugger.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -29,6 +29,6 @@ Gets an object that may be used to uniquely identify this builder to the debugge
 private object ObjectIdForDebugger  
 ```  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asynctaskmethodbuilder-tresult-structure-internal-members.md

@@ -15,7 +15,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncTaskMethodBuilder<TResult> Structure - Internal Members
+# AsyncTaskMethodBuilder<TResult> structure - internal members
 This topic describes the internal members of the <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601> class. For general information about this class, see the <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601> reference topic.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -26,19 +26,19 @@ This topic describes the internal members of the <xref:System.Runtime.CompilerSe
 
 ## Syntax  
 
-```  
+```csharp  
 .class public sequential ansi sealed beforefieldinit System.Runtime.CompilerServices.AsyncTaskMethodBuilder`1<TResult>  
        extends System.ValueType  
        implements System.Runtime.CompilerServices.IAsyncMethodBuilder  
 ```  
 
-## Internal Members  
+## Internal members  
 
 |Name|Description|  
 |----------|-----------------|  
 |[ObjectIdForDebugger property](../../extensibility/debugger/asynctaskmethodbuilder-tresult-objectidfordebugger-property.md)|Gets an object that may be used to uniquely identify this builder to the debugger.|  
 |[m_task field](../../extensibility/debugger/asynctaskmethodbuilder-tresult-m-task-field.md)|Represents the lazily initialized built task.|  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncTaskMethodBuilder%601>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asyncvoidmethodbuilder-m-objectidfordebugger-field.md

@@ -14,7 +14,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncVoidMethodBuilder.m_objectIdForDebugger Field
+# AsyncVoidMethodBuilder.m_objectIdForDebugger field
 Represents the lazily initialized object used by the debugger to uniquely identify this builder.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -25,10 +25,10 @@ Represents the lazily initialized object used by the debugger to uniquely identi
 
 ## Syntax  
 
-```  
+```csharp  
 .field private object m_objectIdForDebugger  
 ```  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncVoidMethodBuilder>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asyncvoidmethodbuilder-objectidfordebugger-property.md

@@ -14,8 +14,8 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncVoidMethodBuilder.ObjectIdForDebugger Property
-Gets an object that may be used to uniquely identify this builder to the debugger.  
+# AsyncVoidMethodBuilder.ObjectIdForDebugger property
+Gets an object that can be used to uniquely identify this builder to the debugger.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
 
@@ -31,4 +31,4 @@ private object ObjectIdForDebugger
 
 ## See Also  
  <xref:System.Runtime.CompilerServices.AsyncVoidMethodBuilder>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/asyncvoidmethodbuilder-structure-internal-members.md

@@ -15,7 +15,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# AsyncVoidMethodBuilder Structure - Internal Members
+# AsyncVoidMethodBuilder structure - internal members
 This topic describes the internal members of the <xref:System.Runtime.CompilerServices.AsyncVoidMethodBuilder> class. For general information about this class, see the <xref:System.Runtime.CompilerServices.AsyncVoidMethodBuilder> reference topic.  
 
  **Namespace:** <xref:System.Runtime.CompilerServices?displayProperty=fullName>  
@@ -26,19 +26,19 @@ This topic describes the internal members of the <xref:System.Runtime.CompilerSe
 
 ## Syntax  
 
-```  
+```csharp  
 .class public sequential ansi sealed beforefieldinit System.Runtime.CompilerServices.AsyncVoidMethodBuilder  
        extends System.ValueType  
        implements System.Runtime.CompilerServices.IAsyncMethodBuilder  
 ```  
 
-## Internal Members  
+## Internal members  
 
 |Name|Description|  
 |----------|-----------------|  
 |[ObjectIdForDebugger property](../../extensibility/debugger/asyncvoidmethodbuilder-objectidfordebugger-property.md)|Gets an object that may be used to uniquely identify this builder to the debugger.|  
 |[m_objectIdForDebugger field](../../extensibility/debugger/asyncvoidmethodbuilder-m-objectidfordebugger-field.md)|Represents the lazily initialized object used by the debugger to uniquely identify this builder.|  
 
-## See Also  
+## See also  
  <xref:System.Runtime.CompilerServices.AsyncVoidMethodBuilder>   
- [Parallel Extension Internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)
+ [Parallel extension internals for the .NET Framework](../../extensibility/debugger/parallel-extension-internals-for-the-dotnet-framework.md)

docs/extensibility/debugger/attaching-after-a-launch.md

@@ -14,36 +14,36 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# Attaching After a Launch
-After a program has been launched, the debug session is ready to attach the debug engine (DE) to said program.  
+# Attach after a launch
+After a program launches, the debug session is ready to attach the debug engine (DE) to said program.  
 
-## Design Decisions  
- Because communication is easier within a shared address space, you must decide whether it makes more sense to facilitate the communication between the debug session and the DE, or between the DE and the program. Choose between the following:  
+## Design decisions  
+ Because communication is easier within a shared address space, you must choose between two design approaches: set communication between the debug session and the DE. Or, set communication between the DE and the program. Choose between the following:  
 
--   If it makes more sense to facilitate communication between the debug session and the DE, then the debug session co-creates the DE and asks the DE to attach to the program. This leaves the debug session and DE together in one address space, and the run-time environment and program together in another.  
+-   If it makes more sense to set up the communication between the debug session and the DE, the debug session co-creates the DE and asks the DE to attach to the program. This design leaves the debug session and DE together in one address space, and the run-time environment and program together in another.  
 
--   If it makes more sense to facilitate communication between the DE and the program, then the run-time environment co-creates the DE. This leaves the SDM in one address space, and the DE, run-time environment, and program together in another. This is typical of a DE that is implemented with an interpreter to run scripted languages.  
+-   If it makes more sense to set up the communication between the DE and the program, the run-time environment co-creates the DE. This design leaves the SDM in one address space and the DE, run-time environment, and program together in another. This design is typical of a DE that is implemented with an interpreter to run scripted languages.  
 
     > [!NOTE]
     >  How the DE attaches to the program is implementation-dependent. Communication between the DE and the program is also implementation-dependent.  
   
 ## Implementation  
- Programmatically, when the session debug manager (SDM) first receives the [IDebugProgram2](../../extensibility/debugger/reference/idebugprogram2.md) object that represents the program to be launched, it calls the [Attach](../../extensibility/debugger/reference/idebugprogram2-attach.md) method, passing it an [IDebugEventCallback2](../../extensibility/debugger/reference/idebugeventcallback2.md) object, which is later used to pass debug events back to the SDM. The `IDebugProgram2::Attach` method then calls the [OnAttach](../../extensibility/debugger/reference/idebugprogramnodeattach2-onattach.md) method. For more information on how the SDM receives the `IDebugProgram2` interface, see [Notifying the Port](../../extensibility/debugger/notifying-the-port.md).  
+ Programmatically, when the session debug manager (SDM) first receives the [IDebugProgram2](../../extensibility/debugger/reference/idebugprogram2.md) object that represents the program to be launched, it calls the [Attach](../../extensibility/debugger/reference/idebugprogram2-attach.md) method, passing it an [IDebugEventCallback2](../../extensibility/debugger/reference/idebugeventcallback2.md) object, which is later used to pass debug events back to the SDM. The `IDebugProgram2::Attach` method then calls the [OnAttach](../../extensibility/debugger/reference/idebugprogramnodeattach2-onattach.md) method. For more information on how the SDM receives the `IDebugProgram2` interface, see [Notifying the port](../../extensibility/debugger/notifying-the-port.md).  
 
- If your DE needs to run in the same address space as the program being debugged, typically because the DE is part of an interpreter running a script, the `IDebugProgramNodeAttach2::OnAttach` method returns `S_FALSE`, indicating that it completed the attach process.  
+ If your DE needs to run in the same address space as the program you're debugging: because the DE is typically part of an interpreter that's running a script, the `IDebugProgramNodeAttach2::OnAttach` method returns `S_FALSE`. The `S_FALSE` return indicates that it completed the attach process.  
 
- If, on the other hand, the DE runs in the address space of the SDM, the `IDebugProgramNodeAttach2::OnAttach` method returns `S_OK` or the [IDebugProgramNodeAttach2](../../extensibility/debugger/reference/idebugprogramnodeattach2.md) interface is not implemented at all on the [IDebugProgramNode2](../../extensibility/debugger/reference/idebugprogramnode2.md) object associated with the program being debugged. In this case, the [Attach](../../extensibility/debugger/reference/idebugengine2-attach.md) method is eventually called to complete the attach operation.  
+ If, however, the DE runs in the address space of the SDM: the `IDebugProgramNodeAttach2::OnAttach` method returns `S_OK`, or the [IDebugProgramNodeAttach2](../../extensibility/debugger/reference/idebugprogramnodeattach2.md) interface isn't implemented at all on the [IDebugProgramNode2](../../extensibility/debugger/reference/idebugprogramnode2.md) object associated with the program you're debugging. In this case, the [Attach](../../extensibility/debugger/reference/idebugengine2-attach.md) method is eventually called to complete the attach operation.  
 
  In the latter case, you must call the [GetProgramId](../../extensibility/debugger/reference/idebugprogram2-getprogramid.md) method on the `IDebugProgram2` object that was passed to the `IDebugEngine2::Attach` method, store the `GUID` in the local program object, and return this `GUID` when the `IDebugProgram2::GetProgramId` method is subsequently called on this object. The `GUID` is used to identify the program uniquely across the various debug components.  
 
- Note that in the case of the `IDebugProgramNodeAttach2::OnAttach` method returning `S_FALSE`, the `GUID` to use for the program is passed to that method and it is the `IDebugProgramNodeAttach2::OnAttach` method that sets the `GUID` on the local program object.  
+ In the case of the `IDebugProgramNodeAttach2::OnAttach` method returning `S_FALSE`, the `GUID` to use for the program is passed to that method and it's the `IDebugProgramNodeAttach2::OnAttach` method that sets the `GUID` on the local program object.  
 
  The DE is now attached to the program and ready to send any startup events.  
 
-## See Also  
- [Attaching Directly to a Program](../../extensibility/debugger/attaching-directly-to-a-program.md)   
- [Notifying the Port](../../extensibility/debugger/notifying-the-port.md)   
- [Debugging Tasks](../../extensibility/debugger/debugging-tasks.md)   
+## See also  
+ [Attaching directly to a program](../../extensibility/debugger/attaching-directly-to-a-program.md)   
+ [Notifying the port](../../extensibility/debugger/notifying-the-port.md)   
+ [Debugging tasks](../../extensibility/debugger/debugging-tasks.md)   
  [IDebugEventCallback2](../../extensibility/debugger/reference/idebugeventcallback2.md)   
  [IDebugProgram2](../../extensibility/debugger/reference/idebugprogram2.md)   
  [Attach](../../extensibility/debugger/reference/idebugprogram2-attach.md)