Home.md

 CDS software packages
 =====================
 
-This page describes how to use the CDS Debian software archives.  Debian is the primary supported operating system the Advanced LIGO Real Time System (RTS).
+This page describes how to use the CDS Debian software archives.  Debian is the primary supported operating system for the Advanced LIGO Real Time System (RTS).
 
-Currently the targeted Debian version is [Debian 9 "stretch"](https://www.debian.org/releases/stretch/), but we plan on supporting [Debian 10 "buster"](https://www.debian.org/releases/buster/) soon.  The following assumes that you already have the appropriate Debian system installed.
+Currently the targeted Debian version is [Debian 9 "stretch"](https://www.debian.org/releases/stretch/), but we will be fully supporting [Debian 10 "buster"](https://www.debian.org/releases/buster/) soon.  The following assumes that you already have the appropriate Debian system installed.
 
-CDS workstation software is also currently supported on Scientific Linux 7.  Please see the [Scientific Linux 7 CDS workstation install](https://cdswiki.ligo-la.caltech.edu/foswiki/bin/view/CDS/StandaloneOffsiteWorkstationInstallationSL7) page for information about installations on that platform.
+CDS workstation software is also supported on Scientific Linux 7.  Please see the [Scientific Linux 7 CDS workstation install](https://cdswiki.ligo-la.caltech.edu/foswiki/bin/view/CDS/StandaloneOffsiteWorkstationInstallationSL7) page for information about installations on that platform.
 
-Please report packaging issues either to the relevant [CDS project](https://git.ligo.org/groups/cds/-/issues) or to the [CDS packaging project](https://git.ligo.org/groups/cds-packaging/-/issues) for support third-party software.
+Please report packaging issues either to the relevant [CDS project](https://git.ligo.org/groups/cds/-/issues) or to the [CDS packaging project](https://git.ligo.org/groups/cds-packaging/-/issues) for supported third-party software.
 
 Adding LSCSoft archives
 -----------------------
@@ -27,16 +27,16 @@ $ sudo apt-get -y --force-yes install lscsoft-archive-keyring
 Adding CDS archives
 -------------------
 
-CDSSoft provides "cdssoft-release-<release>" packages that handle setting up the sources, adding keys, pinning, etc.:
+CDSSoft provides "cdssoft-release-<release>" packages that handle setting up the apt source, adding signing keys, pinning, etc.:
 
-* [cdssoft-release-stretch](http://apt.ligo-wa.caltech.edu/debian/pool/stretch-unstable/cdssoft-release-stretch/cdssoft-release-stretch_1.3.2_all.deb)
-* [cdssoft-release-buster](http://apt.ligo-wa.caltech.edu/debian/pool/buster-unstable/cdssoft-release-buster/cdssoft-release-buster_1.0.2_all.deb)
+* [cdssoft-release-stretch](http://apt.ligo-wa.caltech.edu/debian/pool/stretch-unstable/cdssoft-release-stretch/)
+* [cdssoft-release-buster](http://apt.ligo-wa.caltech.edu/debian/pool/buster-unstable/cdssoft-release-buster/)
 
-In order to install first download manually with e.g. wget, then install the package manually with dpkg, e.g.:
+To install, first manually download (with e.g. wget) the appropriate `cdssoft-release-$SUITE_$VERS_all.deb` package and install manually with dpkg, e.g.:
 
 ```shell
-$ wget -c http://apt.ligo-wa.caltech.edu/debian/pool/stretch-unstable/cdssoft-release-stretch/cdssoft-release-stretch_1.3.2_all.deb
-$ sudo dpkg -i cdssoft-release-stretch_1.3.2_all.deb
+$ wget -c http://apt.ligo-wa.caltech.edu/debian/pool/$SUITE-unstable/cdssoft-release-$SUITE/cdssoft-release-$SUITE_$VERS_all.deb
+$ sudo dpkg -i cdssoft-release-$SUITE_$VERS_all.deb
 $ sudo apt update
 ```