Notes on version matching

Author: nblumhardt

src/Serilog.Extensions.Logging/Serilog.Extensions.Logging.csproj

@@ -2,9 +2,11 @@
 
   <PropertyGroup>
     <Description>Low-level Serilog provider for Microsoft.Extensions.Logging</Description>
+    <!-- This must match the major and minor components of the referenced Microsoft.Extensions.Logging package. -->
     <VersionPrefix>7.0.0</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
-    <!-- These must match the Dependencies tab in https://www.nuget.org/packages/microsoft.extensions.logging -->
+    <!-- These must match the Dependencies tab in https://www.nuget.org/packages/microsoft.extensions.logging at
+         the target version. -->
     <TargetFrameworks>net462;netstandard2.0;netstandard2.1;net6.0;net7.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <PackageTags>serilog;Microsoft.Extensions.Logging</PackageTags>
@@ -26,6 +28,7 @@
     <None Include="..\..\README.md" Pack="true" PackagePath="\" Visible="false" />
     <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All" />
     <PackageReference Include="Serilog" Version="2.12.0" />
+    <!-- The version of this reference must match the major and minor components of the package version prefix. -->
     <PackageReference Include="Microsoft.Extensions.Logging" Version="7.0.0" />
     <PackageReference Include="Nullable" Version="1.3.1" PrivateAssets="All" />
   </ItemGroup>