diff --git a/EventSourcing.NetCore.sln b/EventSourcing.NetCore.sln
index 381295bb7..264e20f11 100644
--- a/EventSourcing.NetCore.sln
+++ b/EventSourcing.NetCore.sln
@@ -221,6 +221,9 @@ EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ECommerce.Core", "Sample\EventStoreDB\Simple\ECommerce.Core\ECommerce.Core.csproj", "{D3351193-F63A-43F1-BB70-C9F4D25887CA}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "EventPipelines", "EventPipelines", "{D9799DB3-9D11-4909-8133-64CD96F6E1AC}"
+	ProjectSection(SolutionItems) = preProject
+		Sample\EventPipelines\README.md = Sample\EventPipelines\README.md
+	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EventPipelines", "Sample\EventPipelines\EventPipelines\EventPipelines.csproj", "{622B15BD-9675-431E-B3F0-336D4E50E30F}"
 EndProject
diff --git a/Sample/EventPipelines/README.md b/Sample/EventPipelines/README.md
index 5d2c7a98c..7eefb79e1 100644
--- a/Sample/EventPipelines/README.md
+++ b/Sample/EventPipelines/README.md
@@ -1,4 +1,4 @@
-## [Event Pipelines](./EventPipelines)
+# [Event Pipelines](./EventPipelines)
 
 Shows how to compose event handlers in the processing pipelines to:
 - filter events,
@@ -96,3 +96,15 @@ var builder = EventHandlersBuilder
 
 var eventBus = new EventBus(builder);
 ```
+
+## Samples
+
+Check different ways of defining and integrating Event Handlers:
+- [Pure functions with Builder](./EventPipelines.Tests/PureFunctionsWithBuilderTest.cs)
+- [Pure functions with Dependency Injection](./EventPipelines.Tests/PureFunctionsWithIoCTest.cs)
+- [Classes with Builder](./EventPipelines.Tests/PureFunctionsWithBuilderTest.cs)
+- [Classes with Dependency Injection](./EventPipelines.Tests/ClassesWithIoCTest.cs)
+
+And how to integrate with MediatR:
+- [Pure functions](./EventPipelines.Tests/PureFunctionsWithMediatRTest.cs)
+- [Classes](./EventPipelines.Tests/ClassesWithMediatRTest.cs)