Merge pull request #10403 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/visualstudio-docs (branch main)

Author: huypub

docs/msbuild/how-to-use-project-sdk.md

@@ -45,53 +45,56 @@ During evaluation of the project, MSBuild adds implicit imports at the top and b
 
 There are three ways to reference a project SDK:
 
-- Use the `Sdk` attribute on the `<Project/>` element:
-
-    ```xml
-    <Project Sdk="My.Custom.Sdk">
-        ...
-    </Project>
-    ```
-
-    An implicit import is added to the top and bottom of the project as discussed previously.
-    
-    To specify a specific version of the SDK, append it to the `Sdk` attribute:
-
-    ```xml
-    <Project Sdk="My.Custom.Sdk/1.2.3">
-        ...
-    </Project>
-    ```
-
-- Use the top-level `<Sdk/>` element:
-
-    ```xml
-    <Project>
-        <Sdk Name="My.Custom.Sdk" Version="1.2.3" />
-        ...
-    </Project>
-   ```
-
-   An implicit import is added to the top and bottom of the project as discussed previously.
-   
-   The `Version` attribute is not required.
+### Use the `Sdk` attribute on the `<Project/>` element
+
+```xml
+<Project Sdk="My.Custom.Sdk">
+    ...
+</Project>
+```
+
+An implicit import is added to the top and bottom of the project as discussed previously.
+
+To specify a specific version of the SDK, append it to the `Sdk` attribute:
+
+```xml
+<Project Sdk="My.Custom.Sdk/1.2.3">
+    ...
+</Project>
+```
+
+### Use the top-level `<Sdk/>` element
+
+```xml
+<Project>
+    <Sdk Name="My.Custom.Sdk" Version="1.2.3" />
+    ...
+</Project>
+```
+
+An implicit import is added to the top and bottom of the project as discussed previously.
+
+The `Version` attribute is not required.
+
+### Use the `<Import/>` element anywhere in your project
 
-- Use the `<Import/>` element anywhere in your project:
+```xml
+<Project>
+    <PropertyGroup>
+        <MyProperty>Value</MyProperty>
+    </PropertyGroup>
+    <Import Project="Sdk.props" Sdk="My.Custom.Sdk" />
+    ...
+    <Import Project="Sdk.targets" Sdk="My.Custom.Sdk" />
+</Project>
+```
 
-    ```xml
-    <Project>
-        <PropertyGroup>
-            <MyProperty>Value</MyProperty>
-        </PropertyGroup>
-        <Import Project="Sdk.props" Sdk="My.Custom.Sdk" />
-        ...
-        <Import Project="Sdk.targets" Sdk="My.Custom.Sdk" />
-    </Project>
-   ```
+Explicitly including the imports in your project allows you full control over the order.
 
-   Explicitly including the imports in your project allows you full control over the order.
+When using the `<Import/>` element, you can specify an optional `Version` attribute as well. For example, you can specify `<Import Project="Sdk.props" Sdk="My.Custom.Sdk" Version="1.2.3" />`.
 
-   When using the `<Import/>` element, you can specify an optional `Version` attribute as well. For example, you can specify `<Import Project="Sdk.props" Sdk="My.Custom.Sdk" Version="1.2.3" />`.
+> [!WARNING]
+> If you are changing project to use `<Import/>` elements, make sure you add both `.props` and `.targets` imports and that you remove the SDK from the `<Project/>` element and `<Sdk/>` elements. Failure to do so will result in doubled imports and an `MSB4011` warning.
 
 ## How project SDKs are resolved