reqnroll · 304NotModified · Aug 16, 2025 · Aug 16, 2025 · Aug 16, 2025 · Aug 16, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,9 +2,12 @@
 
 ## Improvements:
 
+* Add xUnit 3 support (#405, #538)
+* Add READMEs and XML documentation to all NuGet packages (#844)
+
 ## Bug fixes:
 
-*Contributors of this release (in alphabetical order):* 
+*Contributors of this release (in alphabetical order):* @304NotModified, @chekkan
 
 # v3.3.3 - 2026-01-27
 
@@ -123,6 +126,7 @@
 * Fix: Dry Run mode doesn't work properly if the project contains hooks that register & inject custom dependencies (#862)
 
 *Contributors of this release (in alphabetical order):* @chekkan, @Code-Grump, @DrEsteban, @gasparnagy, @konarx
+>>>>>>> b9f0963d1222796b757ea5a28544cd24fd3f2110
 
 # v3.0.3 - 2025-09-17
 

diff --git a/Plugins/Reqnroll.Assist.Dynamic/Reqnroll.Assist.Dynamic/Reqnroll.Assist.Dynamic.csproj b/Plugins/Reqnroll.Assist.Dynamic/Reqnroll.Assist.Dynamic/Reqnroll.Assist.Dynamic.csproj
@@ -7,6 +7,8 @@
 
     <IsReqnrollRuntimePlugin>true</IsReqnrollRuntimePlugin>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- Assembly signing -->
     <AssemblyOriginatorKeyFile>$(ReqnrollKeyFile)</AssemblyOriginatorKeyFile>

diff --git a/Plugins/Reqnroll.Autofac.ReqnrollPlugin/README.md b/Plugins/Reqnroll.Autofac.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.Autofac provides [Autofac](https://github.com/autofac/Autofac) dependency injection integration for Reqnroll.
+
+Plugin supports both registration of dependencies globally and per scenario
+
+## Documentation
+
+For more information about using dependency injection with Reqnroll, see [Autofac - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/autofac.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.Autofac.ReqnrollPlugin/Reqnroll.Autofac.ReqnrollPlugin.csproj b/Plugins/Reqnroll.Autofac.ReqnrollPlugin/Reqnroll.Autofac.ReqnrollPlugin.csproj
@@ -2,6 +2,8 @@
   <PropertyGroup>
     <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <RootNamespace>Reqnroll.Autofac</RootNamespace>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <IsReqnrollRuntimePlugin>true</IsReqnrollRuntimePlugin>
 

diff --git a/Plugins/Reqnroll.CustomPlugin/README.md b/Plugins/Reqnroll.CustomPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.CustomPlugin provides the required dependencies for writing custom Reqnroll generator extensions.
+
+This package serves as a template and example for creating custom plugins that extend Reqnroll functionality. It demonstrates how to create custom generators, transformations, and other extensions.
+
+## Documentation
+
+For more information about creating custom generator plugins, see [Generator Plugins - Reqnroll documentation](https://docs.reqnroll.net/latest/extend/plugins.html#generator-plugins).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.CustomPlugin/Reqnroll.CustomPlugin.csproj b/Plugins/Reqnroll.CustomPlugin/Reqnroll.CustomPlugin.csproj
@@ -5,6 +5,11 @@
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <IncludeMainProjectInDepsFile>false</IncludeMainProjectInDepsFile>
 
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+    <NoPackageAnalysis>true</NoPackageAnalysis>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+
     <!-- NuGet configuration -->
     <PackageId>Reqnroll.CustomPlugin</PackageId>
     <Description>Package for writing custom generator extensions for Reqnroll.</Description>

diff --git a/Plugins/Reqnroll.ExternalData/Reqnroll.ExternalData.ReqnrollPlugin/README.md b/Plugins/Reqnroll.ExternalData/Reqnroll.ExternalData.ReqnrollPlugin/README.md
@@ -0,0 +1,15 @@
+Reqnroll.ExternalData provides external data loading capabilities for Reqnroll scenarios.
+
+The Reqnroll ExternalData plugin lets teams separate test data from test scenarios, and reuse examples across a large set of scenarios. This is particularly helpful when a common set of examples needs to be consistently verified in different scenarios.
+
+Supported Data Sources: CSV, JSON, and excel files
+
+## Documentation
+
+For more information about using external data with Reqnroll, see [External Data Plugin - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/externaldata.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/...rnalData/Reqnroll.ExternalData.ReqnrollPlugin/Reqnroll.ExternalData.ReqnrollPlugin.csproj b/...rnalData/Reqnroll.ExternalData.ReqnrollPlugin/Reqnroll.ExternalData.ReqnrollPlugin.csproj
@@ -6,6 +6,9 @@
 
     <!-- NuGet configuration -->
     <PackageId>Reqnroll.ExternalData</PackageId>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
     <Description>Package to use external data in Gherkin scenarios</Description>
     <PackageTags>reqnroll externaldata json</PackageTags>
   </PropertyGroup>

diff --git a/Plugins/Reqnroll.MSTest.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.MSTest.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.MSTest enables using Reqnroll with [MSTest v2 test framework](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-csharp-with-mstest).
+
+This package provides integration between Reqnroll and MSTest v2, allowing you to write BDD tests using Gherkin syntax that run with the MSTest test framework.
+
+## Documentation
+
+For more information about using Reqnroll with MSTest, visit the [MSTest - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/mstest.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.MSTest.ReqnrollPlugin/Reqnroll.MSTest.ReqnrollPlugin.csproj b/Plugins/Reqnroll.MSTest.ReqnrollPlugin/Reqnroll.MSTest.ReqnrollPlugin.csproj
@@ -3,6 +3,8 @@
   <PropertyGroup>
     <TargetFramework>netstandard2.0</TargetFramework>
     <IsReqnrollTestFrameworkAdapter>true</IsReqnrollTestFrameworkAdapter>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.MSTest</PackageId>

diff --git a/Plugins/Reqnroll.Microsoft.Extensions.DependencyInjection.ReqnrollPlugin/README.md b/Plugins/Reqnroll.Microsoft.Extensions.DependencyInjection.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.Microsoft.Extensions.DependencyInjection provides [Microsoft.Extensions.DependencyInjection](https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection-usage) integration for Reqnroll.
+
+This package enables Reqnroll to use the dependency injection container from the Microsoft.Extensions.DependencyInjection package for resolving step definitions, hooks, and other dependencies in your BDD tests.
+
+## Documentation
+
+For more information about using dependency injection with Reqnroll, see [Microsoft.Extensions.DependencyInjection - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/dependency-injection.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/...on.ReqnrollPlugin/Reqnroll.Microsoft.Extensions.DependencyInjection.ReqnrollPlugin.csproj b/...on.ReqnrollPlugin/Reqnroll.Microsoft.Extensions.DependencyInjection.ReqnrollPlugin.csproj
@@ -5,10 +5,12 @@
     <Nullable>enable</Nullable>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <IsReqnrollRuntimePlugin>true</IsReqnrollRuntimePlugin>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.Microsoft.Extensions.DependencyInjection</PackageId>
-    <PackageTags>reqnroll verify xunit</PackageTags>
+    <PackageTags>reqnroll microsoft extensions di dependency injection</PackageTags>
     <Title>Reqnroll Microsoft.Extensions.DependencyInjection integration plugin</Title>
     <Description>Reqnroll plugin that enables to use Microsoft.Extensions.DependencyInjection for resolving test dependencies.</Description>
     <Authors>Mark Hoek, Solid Token, Stef Heyenrath, $(ReqnrollAuthors)</Authors>

diff --git a/Plugins/Reqnroll.NUnit.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.NUnit.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.NUnit enables using Reqnroll with [NUnit test framework](https://nunit.org/).
+
+This package provides integration between Reqnroll and NUnit, allowing you to write BDD tests using Gherkin syntax that run with the NUnit test framework.
+
+## Documentation
+
+For more information about using Reqnroll with NUnit, see [NUnit - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/nunit.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.NUnit.ReqnrollPlugin/Reqnroll.NUnit.ReqnrollPlugin.csproj b/Plugins/Reqnroll.NUnit.ReqnrollPlugin/Reqnroll.NUnit.ReqnrollPlugin.csproj
@@ -3,6 +3,8 @@
   <PropertyGroup>
     <TargetFramework>netstandard2.0</TargetFramework>
     <IsReqnrollTestFrameworkAdapter>true</IsReqnrollTestFrameworkAdapter>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.NUnit</PackageId>
@@ -12,7 +14,7 @@
 
   <ItemGroup>
     <!-- PrivateAssets="none" ensures that NUnit build assets are included even if the user does not explicitly add a reference to the 'NUnit' package -->
-    <!-- We can consider removing PrivateAssets="none" in v4 and declaring that the users must add reference to 'MSTest.TestFramework' explicitly. -->
+    <!-- We can consider removing PrivateAssets="none" in v4 and declaring that the users must add reference to 'NUnit' explicitly. -->
     <PackageReference Include="NUnit" Version="3.13.1" PrivateAssets="none" />
   </ItemGroup>
 

diff --git a/Plugins/Reqnroll.SpecFlowCompatibility.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.SpecFlowCompatibility.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,9 @@
+Reqnroll.SpecFlowCompatibility provides compatibility layer for migrating from SpecFlow to Reqnroll.
+
+This package helps ease the [migration from SpecFlow](https://docs.reqnroll.net/latest/guides/migrating-from-specflow.html) by providing compatibility shims and adapters, allowing you to gradually migrate your existing SpecFlow tests to Reqnroll.
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/...SpecFlowCompatibility.ReqnrollPlugin/Reqnroll.SpecFlowCompatibility.ReqnrollPlugin.csproj b/...SpecFlowCompatibility.ReqnrollPlugin/Reqnroll.SpecFlowCompatibility.ReqnrollPlugin.csproj
@@ -2,6 +2,7 @@
   <PropertyGroup>
     <TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
     <IsReqnrollRuntimePlugin>true</IsReqnrollRuntimePlugin>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
 
     <!-- This is required to ensure dependencies are made available for packing -->
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
@@ -12,7 +13,7 @@
     <PackageTags>reqnroll specflow</PackageTags>
 
     <!-- Suppress packing warnings: we intentionally add assemblies to /build and have repeated copies of assemblies. -->
-    <NoWarn>$(NoWarn);NU5100;NU5118</NoWarn>
+    <NoWarn>$(NoWarn);NU5100;NU5118;1591</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>

diff --git a/Plugins/Reqnroll.TUnit.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.TUnit.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,9 @@
+Reqnroll.TUnit enables using Reqnroll with TUnit test framework.
+
+This package provides integration between Reqnroll and [TUnit](https://tunit.dev/), allowing you to write BDD tests using Gherkin syntax that run with the TUnit test framework.
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/...ns/Reqnroll.TUnit.Generator.ReqnrollPlugin/Reqnroll.TUnit.Generator.ReqnrollPlugin.csproj b/...ns/Reqnroll.TUnit.Generator.ReqnrollPlugin/Reqnroll.TUnit.Generator.ReqnrollPlugin.csproj
@@ -3,5 +3,7 @@
     <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <IsReqnrollGeneratorPlugin>true</IsReqnrollGeneratorPlugin>
     <IsPackable>false</IsPackable>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
   </PropertyGroup>
 </Project>
diff --git a/Plugins/Reqnroll.TUnit.ReqnrollPlugin/Reqnroll.TUnit.ReqnrollPlugin.csproj b/Plugins/Reqnroll.TUnit.ReqnrollPlugin/Reqnroll.TUnit.ReqnrollPlugin.csproj
@@ -2,12 +2,13 @@
   <PropertyGroup>
     <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <IsReqnrollTestFrameworkAdapter>true</IsReqnrollTestFrameworkAdapter>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.TUnit</PackageId>
     <Description>Package to use Reqnroll with TUnit 1.3.25 and later.</Description>
     <PackageTags>reqnroll TUnit</PackageTags>
-    <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 

diff --git a/Plugins/Reqnroll.Verify/Reqnroll.Verify.ReqnrollPlugin/README.md b/Plugins/Reqnroll.Verify/Reqnroll.Verify.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.Verify provides integration with [Verify](https://github.com/VerifyTests/Verify) for snapshot testing in Reqnroll scenarios.
+
+This package enables Reqnroll to use Verify for approval/snapshot testing, allowing you to verify complex objects, text outputs, and other test results using the Verify library.
+
+## Documentation
+
+For more information about using Verify with Reqnroll, see [Verify - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/verify.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.Verify/Reqnroll.Verify.ReqnrollPlugin/Reqnroll.Verify.ReqnrollPlugin.csproj b/Plugins/Reqnroll.Verify/Reqnroll.Verify.ReqnrollPlugin/Reqnroll.Verify.ReqnrollPlugin.csproj
@@ -5,6 +5,9 @@
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.Verify</PackageId>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
     <Description>Package to use Verify.Xunit with Reqnroll</Description>
     <PackageTags>reqnroll verify xunit</PackageTags>
   </PropertyGroup>

diff --git a/Plugins/Reqnroll.Windsor.ReqnrollPlugin/README.md b/Plugins/Reqnroll.Windsor.ReqnrollPlugin/README.md
@@ -0,0 +1,13 @@
+Reqnroll.Windsor provides [Castle Windsor](https://github.com/castleproject/Windsor) dependency injection integration for Reqnroll.
+
+This package enables Reqnroll to use Castle Windsor as the dependency injection container for resolving step definitions, hooks, and other dependencies in your BDD tests.
+
+## Documentation
+
+For more information about using dependency injection with Reqnroll, see [Castle Windsor - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/windsor.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.Windsor.ReqnrollPlugin/Reqnroll.Windsor.ReqnrollPlugin.csproj b/Plugins/Reqnroll.Windsor.ReqnrollPlugin/Reqnroll.Windsor.ReqnrollPlugin.csproj
@@ -5,6 +5,8 @@
 
         <!-- NuGet package metadata -->
     <PackageId>Reqnroll.Windsor</PackageId>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
     <PackageTags>reqnroll castle windsor di dependency injection</PackageTags>
     <Title>Reqnroll Windsor integration plugin</Title>
     <Description>Reqnroll plugin that enables to use Windsor for resolving test dependencies.</Description>

diff --git a/Plugins/Reqnroll.xUnit.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.xUnit.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,15 @@
+Reqnroll.xUnit enables using Reqnroll with [xUnit test framework v2](https://xunit.net/docs/getting-started/v2/getting-started).
+
+For xUnit 2, use the package Reqnroll.xunit.v3
+
+This package provides integration between Reqnroll and xUnit, allowing you to write BDD tests using Gherkin syntax that run with the xUnit test framework.
+
+## Documentation
+
+For more information about using Reqnroll with xUnit, see [xUnit - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/xunit.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.xUnit.ReqnrollPlugin/Reqnroll.xUnit.ReqnrollPlugin.csproj b/Plugins/Reqnroll.xUnit.ReqnrollPlugin/Reqnroll.xUnit.ReqnrollPlugin.csproj
@@ -2,6 +2,8 @@
   <PropertyGroup>
     <TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
     <IsReqnrollTestFrameworkAdapter>true</IsReqnrollTestFrameworkAdapter>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.xUnit</PackageId>

diff --git a/Plugins/Reqnroll.xUnit3.Generator.ReqnrollPlugin/README.md b/Plugins/Reqnroll.xUnit3.Generator.ReqnrollPlugin/README.md
@@ -0,0 +1,15 @@
+Reqnroll.xUnit enables using Reqnroll with [xUnit test framework v3](https://xunit.net/docs/getting-started/v3/getting-started).
+
+For xUnit 2, use the package Reqnroll.xUnit
+
+This package provides integration between Reqnroll and xUnit, allowing you to write BDD tests using Gherkin syntax that run with the xUnit test framework.
+
+## Documentation
+
+For more information about using Reqnroll with xUnit, see [xUnit - Reqnroll documentation](https://docs.reqnroll.net/latest/integrations/xunit.html).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Plugins/Reqnroll.xUnit3.ReqnrollPlugin/Reqnroll.xUnit3.ReqnrollPlugin.csproj b/Plugins/Reqnroll.xUnit3.ReqnrollPlugin/Reqnroll.xUnit3.ReqnrollPlugin.csproj
@@ -2,6 +2,8 @@
   <PropertyGroup>
     <TargetFramework>netstandard2.0</TargetFramework>
     <IsReqnrollTestFrameworkAdapter>true</IsReqnrollTestFrameworkAdapter>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
 
     <!-- NuGet package metadata -->
     <PackageId>Reqnroll.xunit.v3</PackageId>

diff --git a/Reqnroll.Generator/README.md b/Reqnroll.Generator/README.md
@@ -0,0 +1,20 @@
+Reqnroll.Generator is the code generation component of the Reqnroll framework.
+
+This package provides code generation capabilities that convert Gherkin feature files into executable test code for the Reqnroll BDD test automation framework for .NET. For generator configuration options, see the [Generator Configuration Documentation](https://docs.reqnroll.net/latest/installation/configuration.html#generator).
+
+## Key Features
+
+- **Code Generation**: Converts Gherkin feature files into C# test code
+- **Test Framework Integration**: Supports multiple test frameworks (MSTest, NUnit, xUnit)
+- **Binding Generation**: Generates binding code and step definition skeletons
+- **Multiple Target Frameworks**: Supports .NET Standard 2.0 and later
+
+## Documentation
+
+For more information about Reqnroll and its components, visit the [documentation](https://docs.reqnroll.net/).
+
+## Support
+
+- [Reqnroll Documentation](https://docs.reqnroll.net/)
+- [GitHub Issues](https://github.com/reqnroll/Reqnroll/issues)
+- [Community Discussions](https://github.com/reqnroll/Reqnroll/discussions)
diff --git a/Reqnroll.Generator/Reqnroll.Generator.csproj b/Reqnroll.Generator/Reqnroll.Generator.csproj
@@ -8,12 +8,19 @@
     <PackageId>Reqnroll.Generator</PackageId>
 
     <AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="System.CodeDom" Version="8.0.0" />
   </ItemGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="README.md" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\Reqnroll.Parser\Reqnroll.Parser.csproj" />
     <ProjectReference Include="..\Reqnroll.Utils\Reqnroll.Utils.csproj" />