diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e75ce86
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Cake.DotNetVersionDetector
+
+Cake.DotNetVersionDetector is set of aliases for [Cake][0] that help simplify using [ASoft .NET Version Detector][1].
+
+[![License](http://img.shields.io/:license-mit-blue.svg)][2]
+
+## Information
+
+| |Stable|Pre-release|
+|:--:|:--:|:--:|
+|GitHub Release|-|[![GitHub release](https://img.shields.io/github/release/cake-contrib/Cake.DotNetVersionDetector.svg)][3]|
+|NuGet|[![MyGet](https://img.shields.io/myget/cake-contrib/vpre/Cake.DotNetVersionDetector.svg)][4]|[![NuGet](https://img.shields.io/nuget/vpre/Cake.DotNetVersionDetector.svg)][5]|
+
+## Build Status
+
+|Develop|Master|
+|:--:|:--:|
+|[![Build status][6]][7]|[![Build status][8]][7]|
+
+## Quick Links
+
+- [API Documentation][9]
+- [Usage Examples][10]
+
+
+[0]: https://cakebuild.net/
+[1]: https://www.asoft.be/prod_netver.html
+[2]: https://mit-license.org/
+[3]: https://github.com/cake-contrib/Cake.DotNetVersionDetector/releases/latest
+[4]: https://www.myget.org/feed/cake-contrib/package/nuget/Cake.DotNetVersionDetector
+[5]: https://www.nuget.org/packages/Cake.DotNetVersionDetector
+[6]: https://github.com/cake-contrib/Cake.DotNetVersionDetector/actions/workflows/build.yml/badge.svg?branch=develop
+[7]: https://github.com/cake-contrib/Cake.DotNetVersionDetector/actions/workflows/build.yml
+[8]: https://github.com/cake-contrib/Cake.DotNetVersionDetector/actions/workflows/build.yml/badge.svg?branch=master
+[9]: https://cakebuild.net/dsl/DotNetVersionDetector/
+[10]: https://cake-contrib.github.io/Cake.DotNetVersionDetector/docs/usage/examples
diff --git a/Source/Cake.DotNetVersionDetector/Cake.DotNetVersionDetector.csproj b/Source/Cake.DotNetVersionDetector/Cake.DotNetVersionDetector.csproj
index ee6b689..0fa6bf0 100644
--- a/Source/Cake.DotNetVersionDetector/Cake.DotNetVersionDetector.csproj
+++ b/Source/Cake.DotNetVersionDetector/Cake.DotNetVersionDetector.csproj
@@ -9,6 +9,10 @@
Cake Contributors
+
+
+
+
@@ -32,6 +36,7 @@
$(PackageSourceProjectUrl).git
All release notes for $(AssemblyName) can be found on our GitHub release page - $(PackageSourceProjectUrl)/releases/tag/$(Version)
Development releases do not contain release notes, please see the closed issues in these cases - $(PackageSourceProjectUrl)/issues?q=milestone:$(FileVersion)+is:closed
+ README.md