diff --git a/README.rst b/README.rst
index 3333348..cdd4d39 100644
--- a/README.rst
+++ b/README.rst
@@ -1,8 +1,7 @@
-A Python Mode-S Decoder
-=======================
+The Python Mode-S Decoder
+=========================
 
-Python library for Mode-S message decoding. Two separate methods are
-implemented to decode the following messages:
+Python library for Mode-S message decoding. Support Downlink Formats (DF) are:
 
 -  Automatic Dependent Surveillance - Broadcast (ADS-B) (DF17)
 
@@ -25,7 +24,7 @@ implemented to decode the following messages:
    - BDS 5,3   Air-referenced state vector
    - BDS 6,0   Heading and speed report
 
-A detailed manual on Mode-S decoding is published by the author, at:
+Detailed manual on Mode-S decoding is published by the author, at:
 http://adsb-decode-guide.readthedocs.io
 
 
@@ -37,17 +36,19 @@ https://github.com/junzis/pyModeS
 API documentation at:
 http://pymodes.readthedocs.io
 
+
 Install
 -------
 
-Checkout source code, or install using pip:
+The easiest installation is to use pip:
 
 ::
 
     pip install pyModeS
 
-Usage
------
+
+Use the library
+---------------
 
 .. code:: python
 
@@ -66,8 +67,7 @@ Common functions:
     pms.bin2int(str)    # Convert binary string to integer
     pms.hex2int(str)    # Convert hexadecimal string to integer
 
-    pms.bin2gray(str)    # Convert binary string to grey code
-    pms.gray2bin(str)    # Convert grey code to binary string
+    pms.gray2int(str)    # Convert grey code to interger
 
 
 Core functions for ADS-B decoding:
@@ -94,7 +94,7 @@ Core functions for ADS-B decoding:
     pms.adsb.airborne_velocity(msg)
 
 
-Hint: When you have a fix position of the aircraft, it is convenient to
+Note: When you have a fix position of the aircraft, it is convenient to
 use `position_with_ref()` method to decode with only one position message
 (either odd or even). This works with both airborne and surface position
 messages. But the reference position shall be with in 180NM (airborne)
@@ -164,7 +164,7 @@ Core functions for EHS decoding:
 
 Developement
 ------------
-To run tests, run the following commands:
+To perform unit tests. First install ``tox`` through pip, Then, run the following commands:
 ```
 $ tox
 ```