diff --git a/docs/core/project-sdk/msbuild-props.md b/docs/core/project-sdk/msbuild-props.md
index d46822b51d561..1a1eb83cc0d61 100644
--- a/docs/core/project-sdk/msbuild-props.md
+++ b/docs/core/project-sdk/msbuild-props.md
@@ -134,6 +134,9 @@ The `TargetFramework` property specifies the target framework version for the ap
 </PropertyGroup>
 ```
 
+> [!NOTE]
+> The `TargetFramework` value is an alias. The .NET SDK parses it and sets the canonical moniker properties: `TargetFrameworkMoniker`, `TargetFrameworkIdentifier`, `TargetFrameworkVersion`, and, if applicable, `TargetPlatformIdentifier`, `TargetPlatformVersion`, and `TargetPlatformMoniker`. If you use a custom alias, you can set these properties directly in your project file.
+
 For more information, see [Target frameworks in SDK-style projects](../../standard/frameworks.md).
 
 ### TargetFrameworks
@@ -149,6 +152,9 @@ Use the `TargetFrameworks` property when you want your app to target multiple pl
 </PropertyGroup>
 ```
 
+> [!NOTE]
+> Starting with .NET SDK 10.0.300, multiple values can resolve to the same effective framework. For example, `<TargetFrameworks>linux;mac</TargetFrameworks>` is valid where both aliases resolve to `net10.0` as the target framework.
+
 For more information, see [Target frameworks in SDK-style projects](../../standard/frameworks.md).
 
 ### NetStandardImplicitPackageVersion