AMQNET-588 Solution clean up
- Update README file
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.
-
