diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9a60bf8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Apache.NMS: The .NET Messaging Service Client API
+For more information see http://activemq.apache.org/nms
+
+### Building
+Visual Studio 2017 or above is required to build Apache.NMS. To build, launch Visual Studio with the nms.sln file and build the solution.
+
+### Testing
+Tests use the NUnit Framework. 
+
+### Documentation 
+NMS documentation is generated automatically using [DocFX](https://dotnet.github.io/docfx/) after build. Documentation files are available under folder:
+
+`<root_directory>\docs\_site`
\ No newline at end of file
diff --git a/README.txt b/README.txt
deleted file mode 100644
index 27aa5ca..0000000
--- a/README.txt
+++ /dev/null
@@ -1,54 +0,0 @@
-=======================================================================
-Welcome to:
- * Apache.NMS : The .NET Messaging Service Client API
-=======================================================================
-
-For more information see http://activemq.apache.org/nms
-
-=======================================================================
-Building With NAnt 0.86 see http://nant.sourceforge.net/
-=======================================================================
-
-NAnt version 0.86 or newer is required to build Apache.NMS.  Version 0.90
-or newer is highly recommended.
-To build the code using NAnt, run:
-
-  nant
-
-The NMS documentation can be generated into three different formats using
-Microsoft's Sandcastle open source product. The Sandcastle Styles project
-was used to enhance the output generated from the current release of Sandcastle.
-
-The Sandcastle project is located here:
-
-http://sandcastle.codeplex.com/
-
-The Sandcastle Styles project is located here:
-
-http://sandcastlestyles.codeplex.com/
-
-To generate the documentation, run:
-
-  nant sandcastle-all
-
-=======================================================================
-Building With Visual Studio 2008
-=======================================================================
-
-First build the project with nant, this will download and install 
-all the 3rd party dependencies for you.
-
-Open the solution File.  Build using "Build"->"Build Solution" 
-menu option.
-
-The resulting DLLs will be in build\${framework}\debug or the 
-build\${framework}\release directories depending on your settings 
-under "Build"->"Configuration Manager"
-
-If you have the Resharper plugin installed in Visual Studio, you can run 
-all the Unit Tests by using the "ReSharper"->"Unit Testing"->"Run All 
-Tests from Solution" menu option.  Please note that you must run an 
-Apache ActiveMQ Broker before kicking off the unit tests.  Otherwise,
-the standalone NUnit test runner can be used.  NUnit version 2.5.8
-is required to build and run the unit tests.
-