diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9e50609
--- /dev/null
+++ b/README.md
@@ -0,0 +1,98 @@
+# CppLinuxSerial
+
+Serial port library written in C++
+
+[](https://travis-ci.org/gbmhunter/CppLinuxSerial)
+
+## Description
+
+Library for communicating with COM ports on a Linux system.
+
+Uses fstream to the file I/O.
+
+## Installation
+
+### Linux, MacOS, Windows
+
+1. Make sure you have `cmake` installed.
+
+1. Clone the git repo onto your local storage.
+
+1. Change into root repo directory:
+
+ ```
+ $ cd CppLinuxSerial
+ ```
+
+1. Create a new build directory and change into it:
+
+ ```bash
+ $ mkdir build
+ $ cd build
+ ```
+
+1. Run cmake on the parent directory to generate makefile:
+
+ ```bash
+ $ cmake ..
+ ```
+
+1. Run make on the generated makefile to generate the static library `libCppLinuxSerial.a` and an unit test executable:
+
+ ```bash
+ $ make
+ ```
+
+1. To install the headers on your system:
+
+ ```bash
+ $ sudo make install
+ ```
+
+1. To run the unit tests (NOTE: because this uses virtual serial ports via `stty`, this only works on Linux!):
+
+ ```bash
+ $ make run_unit_tests
+ ```
+
+ If you get errors such as `Could not open device /dev/ttyS10. Is the device name correct and do you have read/write permission?" thrown in the test fixture's constructor.`, it is probably an issue with either creating the virtual serial ports or permissions to access them.
+
+
+## Dependencies
+
+The following table lists all of the libraries dependencies.
+
+
+
+
+
Dependency
+
Comments
+
+
+
+
+
C++14
+
C++14 used for strongly typed enums, `std::chrono` and literals.
+
+
+
stdio.h
+
snprintf()
+
+
+
stty
+
Used in unit tests to verify the serial port is configured correctly.
+
+
+
+
+## Issues
+
+See GitHub Issues.
+
+## FAQ
+
+1. My code stalls when calling functions like `SerialPort::Read()`. This is probably because the library is set up to do a blocking read, and not enough characters have been received to allow `SerialPort::Read()` to return. Use `SerialPort::SetNumCharsToWait()` to determine how many characters to wait for before returning (set to 0 for non-blocking mode).
+
+## Changelog
+
+See CHANGELOG.md.
\ No newline at end of file
diff --git a/README.rst b/README.rst
deleted file mode 100644
index f7792b8..0000000
--- a/README.rst
+++ /dev/null
@@ -1,64 +0,0 @@
-==============
-CppLinuxSerial
-==============
-
-----------------------------------
-Serial port library written in C++
-----------------------------------
-
-.. image:: https://travis-ci.org/gbmhunter/CppLinuxSerial.svg?branch=master
- :target: https://travis-ci.org/gbmhunter/CppLinuxSerial
-
-.. role:: bash(code)
- :language: bash
-
-Description
-===========
-
-Library for communicating with COM ports on a Linux system.
-
-Uses fstream to the file I/O.
-
-Installation
-============
-
-1. Clone the git repo onto your local storage.
-
-2. Run `make all` to compile and run unit tests. Do not worry about error messages being printed when unit tests are run, the unit tests are designed to specifically cause errors to test the response.
-
-3. To include serial-port-cpp into your embedded (or otherwise) firmware/software project, copy the repo into your project folder (or other suitable place), include the file "/api/SerialPortApi.hpp" from your C++ code, and make sure to compile all the files within "/src/".
-
-
-Dependencies
-============
-
-The following table lists all of the libraries dependencies.
-
-====================== ======================================================================
-Dependency Comments
-====================== ======================================================================
-C++14 C++14 used for strongly typed enums, std::chrono and literals.
- snprintf()
-stty Used in unit tests to verify the serial port is configured correctly.
-====================== ======================================================================
-
-Issues
-======
-
-See GitHub Issues.
-
-Usage
-=====
-
-Nothing here yet...
-
-FAQ
-===
-
-1. My code stalls when calling functions like :code:`SerialPort::Read()`. This is probably because the library is set up to do a blocking read, and not enough characters have been received to allow :code:`SerialPort::Read()` to return. Use :code:`SerialPort::SetNumCharsToWait()` to determine how many characters to wait for before returning (set to 0 for non-blocking mode).
-
-
-Changelog
-=========
-
-See CHANGELOG.md.
\ No newline at end of file