Merge pull request #3089 from MicrosoftDocs/master

8/31 AM Publishing

Author: Saisang

docs/code-quality/c26465.md

@@ -4,7 +4,19 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26465"]
 helpviewer_keywords: ["C26465"]
+description: CppCoreCheck rule that enforces C++ Core Guidelines Type.3
 ---
 # C26465 NO_CONST_CAST_UNNECESSARY
 
-Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast).
+Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. 
+
+## See also
+[C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast)
+
+## Example
+```cpp
+void function(int* const constPtrToInt)
+{
+  auto p = const_cast<int*>(constPtrToInt); // C26465, const is not being removed
+}
+```

docs/code-quality/c26466.md

@@ -4,7 +4,37 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26466"]
 helpviewer_keywords: ["C26466"]
+description: CppCoreCheck rule that enforces C++ Core Guidelines Type.2
 ---
 # C26466 NO_STATIC_DOWNCAST_POLYMORPHIC
 
-Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast).
+Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. 
+
+## See also
+[C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast)
+
+## Example
+```cpp
+struct Base {
+    virtual ~Base();
+};
+
+struct Derived : Base {};
+
+void bad(Base* pb)
+{
+    Derived* test = static_cast<Derived*>(pb); // C26466
+}
+
+void good(Base* pb)
+{
+    if (Derived* pd = dynamic_cast<Derived*>(pb)) 
+    {
+        // ... do something with Derived*
+    }
+    else 
+    {
+        // ... do something with Base*
+    }
+}
+```

docs/code-quality/c26471.md

@@ -4,7 +4,24 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26471"]
 helpviewer_keywords: ["C26471"]
+description: CppCoreCheck rule that enforces C++ Core Guidelines Type.1
 ---
 # C26471 NO_REINTERPRET_CAST_FROM_VOID_PTR
 
-Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast).
+Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. 
+
+## See also
+[C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast)
+
+## Example
+```cpp
+void function(void* pValue) 
+{
+    {
+        int* pointerToInt = reinterpret_cast<int*>(pValue); // C26471, use static_cast instead
+    }
+    {
+        int* pointerToInt = static_cast<int*>(pValue); // Good
+    }
+}
+```

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md

@@ -1,6 +1,7 @@
 ---
 title: "Compiler Warning (level 3) C4686"
-ms.date: "08/27/2018"
+description: "Microsoft C++ compiler warning C4686."
+ms.date: 08/29/2020
 f1_keywords: ["C4686"]
 helpviewer_keywords: ["C4686"]
 ms.assetid: 767c83c2-9e4b-4f9e-88c8-02128ba563f4
@@ -11,9 +12,9 @@ ms.assetid: 767c83c2-9e4b-4f9e-88c8-02128ba563f4
 
 ## Remarks
 
-A class template specialization was not is defined before it was used in a return type. Anything that instantiates the class will resolve C4686; declaring an instance or accessing a member (C\<int>::anything) are also options.
+A class template specialization wasn't defined before it was used in a return type. Anything that instantiates the class resolves C4686; declaring an instance or accessing a member (for example, `C<int>::some_member`) are also options.
 
-This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information.
+This warning is off by default. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
 ## Example
 

docs/standard-library/bit-enum.md

@@ -0,0 +1,43 @@
+---
+title: "endian enum"
+description: "enum used to specify the endianness of scalar types"
+ms.date: "08/27/2020"
+f1_keywords: ["bit/std::endian"]
+helpviewer_keywords: ["std::endian"]
+---
+# endian enum
+
+Indicates the endianness of all scalar types.
+
+## Syntax
+
+```cpp
+enum class endian {
+    little = 0,
+    big = 1,
+    native = little
+ };
+```
+
+### Members
+
+|Element|Description|
+|-|-|
+| `little` | Indicates that scalar types are little-endian. That is, the least significant byte is stored in the smallest address. For example, `0x1234` is stored `0x34` `0x12`.  |
+| `big` | Indicates that scalar types are big-endian, that is, the most significant byte is stored in the smallest address. For example, `0x1234` is stored `0x12` `0x34`.  |
+
+## Remarks
+
+All native scalar types are little-endian for the platforms that Microsoft Visual C++ targets (x86, x64, ARM, ARM64).
+
+## Requirements
+
+**Header:** \<bit>
+
+**Namespace:** std
+
+`/std:c++latest` is required
+
+## See also
+
+[\<bit>](../standard-library/bit.md)