diff --git a/readme.md b/readme.md
index d3e06806..934fb83f 100644
--- a/readme.md
+++ b/readme.md
@@ -219,19 +219,10 @@ packaging experience possible:
 <!-- include src/ThisAssembly.Metadata/readme.md#metadata -->
 <!-- #metadata -->
 This package provides a static `ThisAssembly.Metadata` class with public 
-constants exposing each `[System.Reflection.AssemblyMetadata(..)]` defined for 
-the project.
+constants exposing each `[System.Reflection.AssemblyMetadata(..)]` defined in 
+the project file as [supported by the .NET SDK](https://learn.microsoft.com/en-us/dotnet/standard/assembly/set-attributes-project-file#set-arbitrary-attributes).
 
-![](https://raw.githubusercontent.com/devlooped/ThisAssembly/main/img/ThisAssembly.Metadata.png)
-
-For an attribute declared (i.e. in *AssemblyInfo.cs*) like:
-
-```csharp
-[assembly: System.Reflection.AssemblyMetadataAttribute("Foo", "Bar")]
-```
-
-A corresponding `ThisAssembly.Metadata.Foo` constant with the value `Bar` is provided. 
-The metadata attribute can alternatively be declared using MSBuild syntax in the project 
+The metadata attribute is declared using MSBuild syntax in the project 
 (for .NET 5.0+ projects that have built-in support for `@(AssemblyMetadata)` items):
 
 ```xml
@@ -240,6 +231,11 @@ The metadata attribute can alternatively be declared using MSBuild syntax in the
   </ItemGroup>
 ```
 
+And a corresponding `ThisAssembly.Metadata.Foo` constant with the value `Bar` is provided 
+for this example.
+
+![](https://raw.githubusercontent.com/devlooped/ThisAssembly/main/img/ThisAssembly.Metadata.png)
+
 <!-- #metadata -->
 <!-- src/ThisAssembly.Metadata/readme.md#metadata -->