edit pass

Author: TylerMSFT

docs/ide/include-cleanup-config.md

@@ -1,22 +1,22 @@
 ---
-title: "Configure C/C++ include cleanup in Visual Studio"
-description: "Learn how to configure C/C++ include cleanup."
+title: "Configure C/C++ Include Cleanup in Visual Studio"
+description: "Learn how to configure C/C++ Include Cleanup."
 ms.date: 10/10/2023
 ms.topic: "how-to"
 f1_keywords: ["config include cleanup"]
 helpviewer_keywords: ["config include cleanup"]
 ---
-# Configure C/C++ include cleanup in Visual Studio
+# Configure C/C++ Include Cleanup in Visual Studio
 
 Starting with 17.8 Preview 1, Visual Studio can clean up your `#include`s to improve the quality of your C and C++ code in the following ways:
-- Offers to add header files for code that is only working because the needed header file is included indirectly.
+- Offers to add header files for code that compiles only because a needed header file is included indirectly by another header file.
 - Offers to remove unused header files--improving build times.
 
-This article describes how to configure include cleanup in Visual Studio. For more information about include cleanup, see [C/C++ include cleanup overview](include-cleanup-overview.md).
+This article describes how to configure Include Cleanup in Visual Studio. For more information about Include Cleanup, see [C/C++ Include Cleanup overview](include-cleanup-overview.md).
 
-## Turn on include cleanup
+## Turn on Include Cleanup
 
-The include cleanup feature is on by default. If it isn't active, you can turn it on via **Tools** > **Options** > **Text Editor** > **C/C++** > **Code Cleanup** and select **Enable #include cleanup**.
+The Include Cleanup feature is on by default. If it isn't active, you can turn it on via **Tools** > **Options** > **Text Editor** > **C/C++** > **Code Cleanup** and select **Enable #include cleanup**.
 
 Then use the dropdowns to configure how you want to be notified about opportunities to add indirect headers or remove unused headers:
 
@@ -26,42 +26,42 @@ The Enable # include cleanup checkbox is checked. The dropdowns for Remove unuse
 
 The meanings of the suggestion level options are:
 
-**Refactoring only**: Include cleanup offers actions you can take through the quick action menu when you hover the mouse pointer over an `#include`, or place the cursor on the `#include` line and press Ctrl+period:
+**Refactoring only**: Include Cleanup offers actions you can take through the quick action menu when you hover the mouse pointer over an `#include`, or place the cursor on the `#include` line and press Ctrl+period:
 
 :::image type="complex" source="media/include-cleanup-refactor-lightbulb.png" alt-text="A screenshot of the quick action to remove an unused header":::
 When hovering the cursor over # include iostream, a light bulb appears with the text that # include iostream isn't used in this file."
 :::image-end:::
 
-**Suggestion, Warning, Error**: Include cleanup offers actions it can take via suggestions, warnings, or errors in the Error List window. You determine which. In the following screenshot of the Error List, include cleanup is configured to show unused headers with a warning. Ensure that **Build + Intellisense** is selected in the dropdown filter so that you can see the include cleanup output:
+**Suggestion, Warning, Error**: Include Cleanup offers actions it can take via suggestions, warnings, or errors in the Error List window. You determine which. In the following screenshot of the Error List, Include Cleanup is configured to show unused headers with a warning. Ensure that **Build + Intellisense** is selected in the dropdown filter so that you can see the Include Cleanup output:
 
 :::image type="complex" source="media/include-cleanup-error-list.png" alt-text="A screenshot of the Error List window.":::
 The dropdown filter is set to Build + IntelliSense. A warning is visible: VCIC002 - #include < iostream > isn't used in this file."
 :::image-end:::
 
 **Dimmed**
 
-Include cleanup shows unused headers by dimming the line of the unused header file in the code editor. Hover your cursor over the dimmed `#include` to bring up the quick action menu and choose **Show potential fixes** to see actions related to the unused file.
+Include Cleanup shows unused headers by dimming the line of the unused header file in the code editor. Hover your cursor over the dimmed `#include` to bring up the quick action menu and choose **Show potential fixes**, or click on the lightbulb dropdown, to see actions related to the unused file.
 
 :::image type="complex" source="media/include-cleanup-dimmed-include.png" alt-text="A screenshot of a dimmed #include < iostream > line.":::
 The line for #include < iostream > is dimmed because the line of code that uses iostream is commented out. That line of code is // std::cout << "charSize = " << charSize; The quick action menu is also visible for this line. It says the #include < iostream > isn't used in this file, and has a link to Show potential fixes.
 :::image-end:::
 
-## Configure include cleanup with `.editorconfig`
+## Configure Include Cleanup with `.editorconfig`
 
-There are more options for configuring include cleanup such as excluding specified includes from cleanup suggestions, indicating that some header files are required so that the tool doesn't mark them as unused, and so on. These options are defined in an `.editorconfig` file, that, among other things, can be added to your project to enforce consistent coding styles for everyone that works in the codebase. For more information about adding an `.editorconfig` file to your project, see [Create portable, custom editor settings with EditorConfig](/visualstudio/ide/create-portable-custom-editor-options).
+There are more options for configuring Include Cleanup such as excluding specified includes from cleanup suggestions, indicating that some header files are required so that the tool doesn't mark them as unused, and so on. These options are defined in an `.editorconfig` file, that you can add to your project to, among other things, enforce consistent coding styles for everyone that works in the codebase. For more information about adding an `.editorconfig` file to your project, see [Create portable, custom editor settings with EditorConfig](/visualstudio/ide/create-portable-custom-editor-options).
 
-The `.editorconfig` settings that you can use with include cleanup are:
+The `.editorconfig` settings that you can use with Include Cleanup are:
 
 | Setting | Description | Values | Example |
 |--|--|--|--|
-| `cpp_include_cleanup_add_missing_error_tag_type` | Sets the error level of add transitive include suggestions. | `none`</br>`suggestion`</br>`warning`</br>`error` | `cpp_include_cleanup_add_missing_error_tag_type = suggestion` |
-| `cpp_include_cleanup_remove_unused_error_tag_type` | Sets the error level of remove unused include suggestions. | `none`</br>`suggestion`</br>`warning`</br>`error`</br>`dimmed` | `cpp_include_cleanup_remove_unused_error_tag_type = dimmed` |
-| `cpp_include_cleanup_excluded_files` | Excludes the specified files from include tool cleanup suggestions. You won’t get a suggestion related to the header at all, whether to add it or that it's unused. | filename | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` |
-| `cpp_include_cleanup_required_files` | Specify that usage of file1 requires file2. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | file1:file2 | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` |
-| `cpp_include_cleanup_replacement_files` | Suggest that the usage of file1 be replaced by file2. | file1:file2 | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` |
-| `cpp_include_cleanup_alternate_files` | Suggest that file1 be used as an alternative to file2. Useful for facade files. | file1:file2 | `cpp_include_cleanup_alternate_files = windows.h:minwindef.h, windows.h:winerror.h` |
+| `cpp_include_cleanup_add_missing_error_tag_type` | Sets the error level of add transitive include messages. | `none`</br>`suggestion`</br>`warning`</br>`error` | `cpp_include_cleanup_add_missing_error_tag_type = suggestion` |
+| `cpp_include_cleanup_remove_unused_error_tag_type` | Sets the error level of remove unused include messages. | `none`</br>`suggestion`</br>`warning`</br>`error`</br>`dimmed` | `cpp_include_cleanup_remove_unused_error_tag_type = dimmed` |
+| `cpp_include_cleanup_excluded_files` | Excludes the specified files from Include Cleanup messages. You won’t get a suggestion related to the header at all, whether to add it or that it's unused. | filename | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` |
+| `cpp_include_cleanup_required_files` | Specify that usage of *file1* requires *file2*. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | file1:file2 | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` |
+| `cpp_include_cleanup_replacement_files` | Suggest replacing *file1* with *file2*. | *file1*:*file2* | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` |
+| `cpp_include_cleanup_alternate_files` | Suggest using *file1* as an alternative to *file2*. Useful for facade files. | *file1*:*file2* | `cpp_include_cleanup_alternate_files = windows.h:minwindef.h, windows.h:winerror.h` |
 
 ## See also
 
-[C/C++ include cleanup overview](include-cleanup-overview.md)\
-[Include cleanup messages](include-cleanup-messages.md)
+[C/C++ Include Cleanup overview](include-cleanup-overview.md)\
+[Include Cleanup messages](include-cleanup-messages.md)

docs/ide/include-cleanup-messages.md

@@ -1,29 +1,29 @@
 ---
-title: "Include cleanup messages"
+title: "Include Cleanup messages"
 description: "Learn what the messages generated by Include Cleanup mean."
 ms.date: 10/10/2023
 ms.topic: "reference"
 f1_keywords: ["VCIC001", "VCIC002"]
 helpviewer_keywords: ["VCIC001", "VCIC002"]
 ---
-# Include cleanup messages
+# Include Cleanup messages
 
-This article describes the messages generated by the include cleanup feature. For more information about include cleanup, see [C/C++ include cleanup overview](include-cleanup-overview.md).
+This article describes the messages generated by the Include Cleanup feature. For more information about Include Cleanup, see [C/C++ Include Cleanup overview](include-cleanup-overview.md).
 
 Starting with 17.8 Preview 1, Visual Studio can clean up your `#include`s to improve the quality of your C and C++ code in the following ways:
 
-- Offers to add header files for code that is only working because the needed header file is included indirectly.
+- Offers to add header files for code that compiles only because a needed header file is included indirectly by another header file.
 - Offers to remove unused header files--improving build times.
 
-You can choose whether messages from Include cleanup appear in the form of suggestions, warnings, or errors in the Error List window. For more information, see [Config C/C++ include cleanup in Visual Studio](include-cleanup-config.md).
+You can choose whether messages from Include Cleanup appear in the form of suggestions, warnings, or errors in the Error List window. For more information, see [Config C/C++ Include Cleanup in Visual Studio](include-cleanup-config.md).
 
-In the following screenshot of the Error List, include cleanup is configured to show unused headers with a warning:
+In the following screenshot of the Error List, Include Cleanup is configured to show unused headers with a warning:
 
 :::image type="complex" source="media/include-cleanup-error-list.png" alt-text="A screenshot of the Error List window.":::
 The dropdown filter is set to Build + IntelliSense. A warning is visible: VCIC002 - #include < iostream > isn't used in this file."
 :::image-end:::
 
-Include cleanup generates the following messages:
+Include Cleanup generates the following messages:
 
 ## `VCIC001`: Content from #include is used in this file and transitively included
 
@@ -37,5 +37,5 @@ This message means that the specified header file is not used in the current fil
 
 ## See also
 
-[C/C++ include cleanup overview](include-cleanup-overview.md)\
-[Config C/C++ include cleanup in Visual Studio](include-cleanup-config.md)
+[C/C++ Include Cleanup overview](include-cleanup-overview.md)\
+[Configure C/C++ Include Cleanup in Visual Studio](include-cleanup-config.md)