diff --git a/doc/source/afs.rst b/doc/source/afs.rst
index bdb7bd8288..f348c17f2a 100644
--- a/doc/source/afs.rst
+++ b/doc/source/afs.rst
@@ -246,6 +246,27 @@ the read-only path.
 
 You should set the volume quota with ``fs setquota``.
 
+Deleting a Volume
+~~~~~~~~~~~~~~~~~
+
+Remove the mountpoint(s) of the volume::
+
+  fs rmmount /afs/.openstack.org/path/to/mountpoint
+
+Be sure to release the parent volume (with ``vos release``) if
+necessary after removing the mountpoint.
+
+Run ``vos examine`` to see a list of volume sites.  Identify the
+read-write and read-only sites.
+
+Remove the read-only sites first; repeat this command for each one::
+
+  vos remove -server $FILESERVER -partition $PARTITION -id $VOLUME.readonly
+
+Remove the read-write volume::
+
+  vos remove -id $VOLUME
+
 Adding a Fileserver
 ~~~~~~~~~~~~~~~~~~~
 Put the machine's public IP on a single line in