diff --git a/README.md b/README.md
index a195972..556ab6c 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # r-builds
 
 This repository orchestrates tools to produce R binaries obtainable from:
-https://cdn.rstudio.com/r/versions.json. The binaries are available as a
+https://cdn.rstudio.com/r. The binaries are available as a
 community resource, **they are not professionally supported by RStudio**. 
 The R language is open source, please see the official documentation at https://www.r-project.org/.
 
@@ -10,7 +10,7 @@ The binaries were built with the following considerations:
 - They use a minimal, documented set of
   [build](https://github.com/rstudio/r-builds/tree/master/builder) and
   [runtime](https://github.com/rstudio/r-docker) dependencies.  
-- They are designed to be used side-by-side, e.g., on [RStudio Server Pro]().
+- They are designed to be used side-by-side, e.g., on [RStudio Server Pro](https://docs.rstudio.com/ide/server-pro/r-versions.html#using-multiple-versions-of-r-concurrently).
 - They give users a consistent option for accessing R across different Linux distributions.
 
 These binaries have been extensively tested, and are used in production everyday
@@ -25,9 +25,9 @@ These binaries are designed to be copied onto a server, as opposed to installed
 using a system package manager like `apt` or `yum`. This approach allows administrators
 to offer multiple versions of R side-by-side. 
 
-```
-# Pre-req install runtime pre-reqs
-# Then copy the desired R version from the CD
+```bash
+# Install runtime pre-reqs
+# Then copy the desired R version from the CDN
 
 OS_IDENTIFIER=ubuntu-1804
 R_VERSION=3.5.3
@@ -48,6 +48,31 @@ ln -s /opt/R/${R_VERSION}/bin/R /usr/bin/R
 ln -s /opt/R/${R_VERSION}/bin/Rscript /usr/bin/Rscript
 ln -s /opt/R/${R_VERSION}/lib/R /usr/lib/R 
 ```
+The R binary can be obtain from the CDN using a URL with the format:  
+
+```
+https://cdn.rstudio.com/r/<OS_IDENTIFIER>/R-<R_VERSION>-<OS_IDENTIFIER>.tar.gz
+```
+
+The list of currently available R versions can be obtained here:
+https://cdn.rstudio.com/r/versions.json.  
+
+The following operating systems are supported:  
+
+|Operating System|OS Identifier| 
+|---|---|
+|CentOS 6|centos-6|
+|CentOS 7|centos-7|
+|Debian 9|debian-9|
+|OpenSUSE 15.1|opensuse-15|
+|OpenSUSE 42.3|opensuse-42|
+|Ubuntu 16.04 Xenial|ubuntu-1604|
+|Ubuntu 18.04 Bionic|ubuntu-1804|
+
+The R binaries are built on these open source containers, but have been tested
+on their commerical equivalents. For example, the CentOS binaries also work on
+RedHat Enterprise Linux (REHL) and the OpenSUSE binaries also worn on SUSE Linux
+Enterprise Server (SLES).
 
 Please see [r-docker](https://github.com/rstudio/r-docker) and
 [r-system-requirements](https://github.com/rstudio/r-system-requirements) for