diff --git a/README.rst b/README.rst
index 55d9d4f..eb6a79a 100644
--- a/README.rst
+++ b/README.rst
@@ -53,9 +53,9 @@ This section describes how to install the toolchain. This procedure is divided i
 2. Choose the install directory
 
 The install directory can either be in your home directory
-such as `~/opt/symbiflow` or in a system directory such as `/opt/symbiflow`.
+such as ``~/opt/symbiflow`` or in a system directory such as ``/opt/symbiflow``.
 If you choose a system directory, you will need root permission to perform the installation,
-and so you will need to add some `sudo` commands to the instructions below.
+and so you will need to add some ``sudo`` commands to the instructions below.
 
 .. code:: bash
 
diff --git a/README.src.rst b/README.src.rst
index 5774ed1..abbaf93 100644
--- a/README.src.rst
+++ b/README.src.rst
@@ -53,9 +53,9 @@ This section describes how to install the toolchain. This procedure is divided i
 2. Choose the install directory
 
 The install directory can either be in your home directory 
-such as `~/opt/symbiflow` or in a system directory such as `/opt/symbiflow`.  
+such as ``~/opt/symbiflow`` or in a system directory such as ``/opt/symbiflow``.  
 If you choose a system directory, you will need root permission to perform the installation, 
-and so you will need to add some `sudo` commands to the instructions below.
+and so you will need to add some ``sudo`` commands to the instructions below.
 
 .. code:: bash
 
diff --git a/eos-s3/README.rst b/eos-s3/README.rst
index f795c47..0d769a0 100644
--- a/eos-s3/README.rst
+++ b/eos-s3/README.rst
@@ -16,12 +16,12 @@ If you have not already done so, clone this repository and `cd` into it:
 Setting up the toolchain
 ------------------------
 
-Choose the installation directory (see the `README.rst <../README.rst>`_ one level up for details):
+Choose the installation directory (see the `README <../README.rst>`_ one level up for details):
 
 
 .. code:: bash
 
-    export INSTALL_DIR=~/opt/symbiflow
+    export INSTALL_DIR=~/opt/symbiflow    # or somewhere else you choose
 
 
 .. toolchain_include_begin_label
diff --git a/xc7/README.rst b/xc7/README.rst
index 293d7d3..a3b5f48 100644
--- a/xc7/README.rst
+++ b/xc7/README.rst
@@ -25,13 +25,12 @@ If you have not already done so, clone this repository and `cd` into it:
 Setting up the toolchain
 ------------------------
 
-Choose the installation directory (see the README_ one level up for details):
+Choose the installation directory (see the `README <../README.rst>`_ one level up for details):
 
-.. _README: ../README.md
 
 .. code:: bash
 
-    export INSTALL_DIR=~/opt/symbiflow
+    export INSTALL_DIR=~/opt/symbiflow   # or somewhere else you choose
 
 .. toolchain_include_begin_label