diff --git a/Atc.Test.sln b/Atc.Test.sln
index 6a84a12..0c16179 100644
--- a/Atc.Test.sln
+++ b/Atc.Test.sln
@@ -26,6 +26,11 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{4B46C47D-D
test\Directory.Build.props = test\Directory.Build.props
EndProjectSection
EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{014851A9-0672-4268-9856-181B0BB26F71}"
+ ProjectSection(SolutionItems) = preProject
+ README.md = README.md
+ EndProjectSection
+EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
diff --git a/README.md b/README.md
index e27c271..eed8a85 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,12 @@
Common tools for writing tests using XUnit, AutoFixture, NSubstitute and FluentAssertions.
+> **Version Notes:**
+> If you are using the `MemberAutoNSubstituteData` attribute, ensure that both `xunit` and `xunit.extensibility.core` packages are set to version **2.9.0**.
+> This is because the latest versions of xUnit are currently incompatible with `MemberAutoNSubstituteData` due to an unresolved issue. Although [xunit/xunit#3031](https://github.com/xunit/xunit/issues/3031) has been closed, the problem remains unresolved.
+> Upgrading beyond version 2.9.0 may result in test failures or unexpected behavior.
+
+
## Test Attributes
| Name | Description |
@@ -12,7 +18,8 @@ Common tools for writing tests using XUnit, AutoFixture, NSubstitute and FluentA
| `InlineAutoNSubstituteData` | Provides a data source for a data theory, with the data coming from inline values combined with auto-generated data specimens generated by AutoFixture and NSubstitute.|
| `MemberAutoNSubstituteData` | Provides a data source for a data theory, with the data coming from one of the following sources and combined with auto-generated data specimens generated by AutoFixture and NSubstitute.|
-Note: NSubstitute is used when the type being created is abstract, or when the `[Substitute]` is applied.
+> **Note:**
+> NSubstitute is used when the type being created is abstract, or when the `[Substitute]` is applied.
## Test Helpers
diff --git a/src/Atc.Test/Atc.Test.csproj b/src/Atc.Test/Atc.Test.csproj
index ae82d2c..3831461 100644
--- a/src/Atc.Test/Atc.Test.csproj
+++ b/src/Atc.Test/Atc.Test.csproj
@@ -20,7 +20,8 @@
-
+
+
diff --git a/test/Atc.Test.Tests/Atc.Test.Tests.csproj b/test/Atc.Test.Tests/Atc.Test.Tests.csproj
index 9bcdabe..9f53b7b 100644
--- a/test/Atc.Test.Tests/Atc.Test.Tests.csproj
+++ b/test/Atc.Test.Tests/Atc.Test.Tests.csproj
@@ -13,7 +13,7 @@
runtime; build; native; contentfiles; analyzers; buildtransitive
all
-
+
runtime; build; native; contentfiles; analyzers; buildtransitive
all