diff --git a/install/README.md b/install/README.md
index 6efac4e395..d8479157b0 100644
--- a/install/README.md
+++ b/install/README.md
@@ -8,5 +8,6 @@ Select your preferred distribution:
 
 For further information, see:
 
-* The [developer guide](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md)
-* The [runtime documentation](https://github.com/kata-containers/runtime/blob/master/README.md)
+* The [the upgrading document](../Upgrading.md).
+* The [developer guide](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md).
+* The [runtime documentation](https://github.com/kata-containers/runtime/blob/master/README.md).
diff --git a/install/centos-installation-guide.md b/install/centos-installation-guide.md
index 38a7edb050..76da61db94 100644
--- a/install/centos-installation-guide.md
+++ b/install/centos-installation-guide.md
@@ -1,6 +1,11 @@
 # Installing Kata Containers on CentOS
 
-Note: Kata Containers is available for CentOS version 7.
+> **Notes:**
+>
+> - Kata Containers packages are available for CentOS version 7 (currently `x86_64` only).
+>
+> - If you are installing on a system that already has Clear Containers or `runv` installed,
+>   first read [the upgrading document](../Upgrading.md).
 
 This step is only required in case Docker is not installed on the system.
 1. Install the latest version of Docker with the following commands:
@@ -15,7 +20,8 @@ For more information on installing Docker please refer to the
 
 2. Install the Kata Containers components with the following commands:
 
-  **Note:** The repository redirects the download content to use `http`, be aware that this installation channel is not secure.
+> **Note:** The repository redirects the download content to use `http`, be aware that this installation channel is not secure.
+
 ```bash
 $ source /etc/os-release
 $ sudo -E VERSION_ID=$VERSION_ID yum-config-manager --add-repo \
diff --git a/install/fedora-installation-guide.md b/install/fedora-installation-guide.md
index 23fd5f1548..ccedfb8e59 100644
--- a/install/fedora-installation-guide.md
+++ b/install/fedora-installation-guide.md
@@ -1,7 +1,11 @@
 # Installing Kata Containers on Fedora
 
-Note:
-Kata Containers is available for Fedora\* versions **26** and **27**.
+> **Notes:**
+>
+> - Kata Containers packages are available for Fedora\* versions **26** and **27** (currently `x86_64` only).
+>
+> - If you are installing on a system that already has Clear Containers or `runv` installed,
+>   first read [the upgrading document](../Upgrading.md).
 
 This step is only required in case Docker is not installed on the system.
 1. Install the latest version of Docker with the following commands:
@@ -18,7 +22,8 @@ For more information on installing Docker please refer to the
 
 2. Install the Kata Containers components with the following commands:
 
-  **Note:** The repository redirects the download content to use `http`, be aware that this installation channel is not secure.
+> **Note:** The repository redirects the download content to use `http`, be aware that this installation channel is not secure.
+
 ```bash
 $ source /etc/os-release
 $ sudo -E VERSION_ID=$VERSION_ID dnf config-manager --add-repo \
diff --git a/install/ubuntu-installation-guide.md b/install/ubuntu-installation-guide.md
index 980479e0b4..2ea4561888 100644
--- a/install/ubuntu-installation-guide.md
+++ b/install/ubuntu-installation-guide.md
@@ -1,9 +1,11 @@
 # Installing Kata Containers on Ubuntu
 
-Note:
-Kata Containers is available for Ubuntu\* **16.04** and **17.10**.
-Currently Kata Containers is currently only build for x86_64.
-
+> **Notes:**
+>
+> - Kata Containers packages are available for Ubuntu\* **16.04** and **17.10** (currently `x86_64` only).
+>
+> - If you are installing on a system that already has Clear Containers or `runv` installed,
+>   first read [the upgrading document](../Upgrading.md).
 
 This step is only required in case Docker is not installed on the system.
 1. Install the latest version of Docker with the following commands:
@@ -22,7 +24,8 @@ For more information on installing Docker please refer to the
 
 2. Install the Kata Containers components with the following commands:
 
-  **Note:** The repository is downloading content using `http`, be aware that this installation channel is not secure.
+> **Note:** The repository is downloading content using `http`, be aware that this installation channel is not secure.
+
 ```bash
 $ sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/katacontainers:/release/xUbuntu_$(lsb_release -rs)/ /' > /etc/apt/sources.list.d/kata-containers.list"
 $ curl -sL  http://download.opensuse.org/repositories/home:/katacontainers:/release/xUbuntu_$(lsb_release -rs)/Release.key | sudo apt-key add -