Merge branch 'main' of https://github.com/MicrosoftDocs/cpp-docs-pr into deopt

Author: TylerMSFT

.github/ISSUE_TEMPLATE/new-c---2017-stl-library-documentation-topic-.md

@@ -1,8 +1,7 @@
 ---
-description: "Learn more about: ATL utilities reference"
 title: "ATL utilities reference"
+description: "Learn more about: ATL utilities reference"
 ms.date: "11/04/2016"
-ms.assetid: dd8a2888-34f4-461e-9bf4-834218f9b95b
 ---
 # ATL utilities reference
 
@@ -47,8 +46,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl
 | [AtlIsUnsafeUrlChar](../atl/reference/atl-http-utility-functions.md#atlisunsafeurlchar) | Call this function to find out whether a character is safe for use in a URL. |
 | [AtlUnescapeUrl](../atl/reference/atl-http-utility-functions.md#atlunescapeurl) | Call this function to convert escaped characters back to their original values. |
 | [SystemTimeToHttpDate](../atl/reference/atl-http-utility-functions.md#systemtimetohttpdate) | Call this function to convert a system time to a string in a format suitable for using in HTTP headers. |
-| [ATLPath::AddBackslash](../atl/reference/atl-path-functions.md#addbackslash) | This function is an overloaded wrapper for [PathAddBackslash](/windows/desktop/api/shlwapi/nf-shlwapi-pathaddbackslasha |
-| ). |
+| [ATLPath::AddBackslash](../atl/reference/atl-path-functions.md#addbackslash) | This function is an overloaded wrapper for [PathAddBackslash](/windows/win32/api/shlwapi/nf-shlwapi-pathaddbackslasha). |
 | [ATLPath::AddExtension](../atl/reference/atl-path-functions.md#addextension) | This function is an overloaded wrapper for [PathAddExtension](/windows/win32/api/shlwapi/nf-shlwapi-pathaddextensionw). |
 | [ATLPath::Append](../atl/reference/atl-path-functions.md#append) | This function is an overloaded wrapper for [PathAppend](/windows/win32/api/shlwapi/nf-shlwapi-pathappendw). |
 | [ATLPath::BuildRoot](../atl/reference/atl-path-functions.md#buildroot) | This function is an overloaded wrapper for [PathBuildRoot](/windows/win32/api/shlwapi/nf-shlwapi-pathbuildrootw). |
@@ -87,5 +85,5 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl
 
 ## See also
 
-[Concepts](../atl/active-template-library-atl-concepts.md)<br/>
+[Concepts](../atl/active-template-library-atl-concepts.md)\
 [ATL COM desktop components](../atl/atl-com-desktop-components.md)

.github/ISSUE_TEMPLATE/new-c---2020-stl-library-documentation-topic-.md

@@ -1,40 +1,39 @@
 ---
-description: "Learn more about: CComCoClass Class"
 title: "CComCoClass Class"
+description: "Learn more about: CComCoClass Class"
 ms.date: "11/04/2016"
 f1_keywords: ["CComCoClass", "ATLCOM/ATL::CComCoClass", "ATLCOM/ATL::CComCoClass::CreateInstance", "ATLCOM/ATL::CComCoClass::Error", "ATLCOM/ATL::CComCoClass::GetObjectCLSID", "ATLCOM/ATL::CComCoClass::GetObjectDescription"]
 helpviewer_keywords: ["CComCoClass class", "aggregation [C++], aggregation models"]
-ms.assetid: 67cfefa4-8df9-47fa-ad58-2d1a1ae25762
 ---
 # CComCoClass Class
 
 This class provides methods for creating instances of a class, and obtaining its properties.
 
 ## Syntax
 
-```
+```cpp
 template <class T, const CLSID* pclsid = &CLSID_NULL>
 class CComCoClass
 ```
 
 #### Parameters
 
-*T*<br/>
+*T*\
 Your class, derived from `CComCoClass`.
 
-*pclsid*<br/>
+*pclsid*\
 A pointer to the CLSID of the object.
 
 ## Members
 
 ### Public Methods
 
-|Name|Description|
-|----------|-----------------|
-|[CComCoClass::CreateInstance](#createinstance)|(Static) Creates an instance of the class and queries for an interface.|
-|[CComCoClass::Error](#error)|(Static) Returns rich error information to the client.|
-|[CComCoClass::GetObjectCLSID](#getobjectclsid)|(Static) Returns the object's class identifier.|
-|[CComCoClass::GetObjectDescription](#getobjectdescription)|(Static) Override to return the object's description.|
+| Name                                                       | Description                                                             |
+| ---------------------------------------------------------- | ----------------------------------------------------------------------- |
+| [CComCoClass::CreateInstance](#createinstance)             | (Static) Creates an instance of the class and queries for an interface. |
+| [CComCoClass::Error](#error)                               | (Static) Returns rich error information to the client.                  |
+| [CComCoClass::GetObjectCLSID](#getobjectclsid)             | (Static) Returns the object's class identifier.                         |
+| [CComCoClass::GetObjectDescription](#getobjectdescription) | (Static) Override to return the object's description.                   |
 
 ## Remarks
 
@@ -58,23 +57,23 @@ You can override either of these defaults by specifying another macro in your cl
 
 Use these `CreateInstance` functions to create an instance of a COM object and retrieve an interface pointer without using the COM API.
 
-```
-template <class  Q>
-static HRESULT CreateInstance( Q** pp);
+```cpp
+template <class Q>
+static HRESULT CreateInstance(Q** pp);
 
-template <class  Q>
+template <class Q>
 static HRESULT CreateInstance(IUnknown* punkOuter, Q** pp);
 ```
 
 ### Parameters
 
-*Q*<br/>
+*Q*\
 The COM interface that should be returned via *pp*.
 
-*punkOuter*<br/>
+*punkOuter*\
 [in] The outer unknown or controlling unknown of the aggregate.
 
-*pp*<br/>
+*pp*\
 [out] The address of a pointer variable that receives the requested interface pointer if creation succeeds.
 
 ### Return Value
@@ -101,7 +100,7 @@ In the following example, `CDocument` is a wizard-generated ATL class derived fr
 
 This static function sets up the `IErrorInfo` interface to provide error information to the client.
 
-```
+```cpp
 static HRESULT WINAPI Error(
     LPCOLESTR lpszDesc,
     const IID& iid = GUID_NULL,
@@ -130,7 +129,7 @@ static HRESULT WINAPI Error(
     UINT nID,
     const IID& iid = GUID_NULL,
     HRESULT hRes = 0,
-    HINSTANCE hInst = _AtlBaseModule.GetResourceInstance ());
+    HINSTANCE hInst = _AtlBaseModule.GetResourceInstance());
 
 static HRESULT Error(
     UINT nID,
@@ -143,25 +142,25 @@ static HRESULT Error(
 
 ### Parameters
 
-*lpszDesc*<br/>
+*lpszDesc*\
 [in] The string describing the error. The Unicode version of `Error` specifies that *lpszDesc* is of type LPCOLESTR; the ANSI version specifies a type of LPCSTR.
 
-*iid*<br/>
+*iid*\
 [in] The IID of the interface defining the error or GUID_NULL (the default value) if the error is defined by the operating system.
 
-*hRes*<br/>
+*hRes*\
 [in] The HRESULT you want returned to the caller. The default value is 0. For more details about *hRes*, see Remarks.
 
-*nID*<br/>
+*nID*\
 [in] The resource identifier where the error description string is stored. This value should lie between 0x0200 and 0xFFFF, inclusively. In debug builds, an **ASSERT** will result if *nID* does not index a valid string. In release builds, the error description string will be set to "Unknown Error."
 
-*dwHelpID*<br/>
+*dwHelpID*\
 [in] The help context identifier for the error.
 
-*lpszHelpFile*<br/>
+*lpszHelpFile*\
 [in] The path and name of the help file describing the error.
 
-*hInst*<br/>
+*hInst*\
 [in] The handle to the resource. By default, this parameter is `_AtlModule::GetResourceInstance`, where `_AtlModule` is the global instance of [CAtlModule](../../atl/reference/catlmodule-class.md).
 
 ### Return Value
@@ -178,7 +177,7 @@ If the *hRes* parameter is nonzero, then `Error` returns the value of *hRes*. If
 
 Provides a consistent way of retrieving the object's CLSID.
 
-```
+```cpp
 static const CLSID& WINAPI GetObjectCLSID();
 ```
 
@@ -190,7 +189,7 @@ The object's class identifier.
 
 This static function retrieves the text description for your class object.
 
-```
+```cpp
 static LPCTSTR WINAPI GetObjectDescription();
 ```
 

.github/ISSUE_TEMPLATE/new-c---2023-stl-library-documentation-topic.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: CComMultiThreadModel Class"
 title: "CComMultiThreadModel Class"
+description: "Learn more about: CComMultiThreadModel Class"
 ms.date: "11/04/2016"
 f1_keywords: ["CComMultiThreadModel", "ATLBASE/ATL::CComMultiThreadModel", "ATLBASE/ATL::CComMultiThreadModel::AutoCriticalSection", "ATLBASE/ATL::CComMultiThreadModel::CriticalSection", "ATLBASE/ATL::CComMultiThreadModel::ThreadModelNoCS", "ATLBASE/ATL::CComMultiThreadModel::Decrement", "ATLBASE/ATL::CComMultiThreadModel::Increment"]
 helpviewer_keywords: ["ATL, multithreading", "CComMultiThreadModel class", "threading [ATL]"]
-ms.assetid: db8f1662-2f7a-44b3-b341-ffbfb6e422a3
 ---
 # CComMultiThreadModel Class
 
 `CComMultiThreadModel` provides thread-safe methods for incrementing and decrementing the value of a variable.
 
 ## Syntax
 
-```
+```cpp
 class CComMultiThreadModel
 ```
 
@@ -35,7 +34,7 @@ class CComMultiThreadModel
 
 ## Remarks
 
-Typically, you use `CComMultiThreadModel` through one of two **`typedef`** names, either [CComObjectThreadModel](atl-typedefs.md#ccomobjectthreadmodel or [CComGlobalsThreadModel](atl-typedefs.md#ccomglobalsthreadmodel. The class referenced by each **`typedef`** depends on the threading model used, as shown in the following table:
+Typically, you use `CComMultiThreadModel` through one of two **`typedef`** names, either [CComObjectThreadModel](atl-typedefs.md#ccomobjectthreadmodel) or [CComGlobalsThreadModel](atl-typedefs.md#ccomglobalsthreadmodel). The class referenced by each **`typedef`** depends on the threading model used, as shown in the following table:
 
 |typedef|Single threading|Apartment threading|Free threading|
 |-------------|----------------------|-------------------------|--------------------|
@@ -54,7 +53,7 @@ S= `CComSingleThreadModel`; M= `CComMultiThreadModel`
 
 When using `CComMultiThreadModel`, the **`typedef`** name `AutoCriticalSection` references class [CComAutoCriticalSection](ccomautocriticalsection-class.md), which provides methods for obtaining and releasing ownership of a critical section object.
 
-```
+```cpp
 typedef CComAutoCriticalSection AutoCriticalSection;
 ```
 
@@ -120,7 +119,7 @@ The following tables show the results of the `InternalAddRef` and `Lock` methods
 
 When using `CComMultiThreadModel`, the **`typedef`** name `CriticalSection` references class [CComCriticalSection](ccomcriticalsection-class.md), which provides methods for obtaining and releasing ownership of a critical section object.
 
-```
+```cpp
 typedef CComCriticalSection CriticalSection;
 ```
 
@@ -144,13 +143,13 @@ See [CComMultiThreadModel::AutoCriticalSection](#autocriticalsection).
 
 This static function calls the Win32 function [InterlockedDecrement](/windows/win32/api/winnt/nf-winnt-interlockeddecrement), which decrements the value of the variable pointed to by *p*.
 
-```
+```cpp
 static ULONG WINAPI Decrement(LPLONG p) throw ();
 ```
 
 ### Parameters
 
-*p*<br/>
+*p*\
 [in] Pointer to the variable to be decremented.
 
 ### Return Value
@@ -165,13 +164,13 @@ If the result of the decrement is 0, then `Decrement` returns 0. If the result o
 
 This static function calls the Win32 function [InterlockedIncrement](/windows/win32/api/winnt/nf-winnt-interlockedincrement), which increments the value of the variable pointed to by *p*.
 
-```
+```cpp
 static ULONG WINAPI Increment(LPLONG p) throw ();
 ```
 
 ### Parameters
 
-*p*<br/>
+*p*\
 [in] Pointer to the variable to be incremented.
 
 ### Return Value
@@ -186,7 +185,7 @@ If the result of the increment is 0, then `Increment` returns 0. If the result o
 
 When using `CComMultiThreadModel`, the **`typedef`** name `ThreadModelNoCS` references class [CComMultiThreadModelNoCS](ccommultithreadmodelnocs-class.md).
 
-```
+```cpp
 typedef CComMultiThreadModelNoCS ThreadModelNoCS;
 ```
 
@@ -208,7 +207,7 @@ See [CComMultiThreadModel::AutoCriticalSection](#autocriticalsection).
 
 ## See also
 
-[CComSingleThreadModel Class](ccomsinglethreadmodel-class.md)<br/>
-[CComAutoCriticalSection Class](ccomautocriticalsection-class.md)<br/>
-[CComCriticalSection Class](ccomcriticalsection-class.md)<br/>
+[CComSingleThreadModel Class](ccomsinglethreadmodel-class.md)\
+[CComAutoCriticalSection Class](ccomautocriticalsection-class.md)\
+[CComCriticalSection Class](ccomcriticalsection-class.md)\
 [Class Overview](../atl-class-overview.md)