-We make available an ability to mirror Condor's YUM repository.
+{section: Mirroring the Condor YUM Repository}
 
-{section: UW-Madison Server Configuration}
 
-Since all of the YUM repo is already publicly available, there is no enforceability to restrict the mirroring of it.
+{subsection: Motivation}
+Some of our collaborators in Europe or other continents would like to keep a locally available mirror for the ease of updating their YUM installs of Condor
+in large pools. Since all of the Condor YUM repository is already publicly available, there is no enforceability to restrict the mirroring of it. Hence it is made available.
+
+{subsection: UW-Madison Server Configuration}
 
 On =parrot.cs.wisc.edu=, in the =/etc/rsyncd.conf= file, you will find these
-configurations. They were set up by the CSL at the Condor Team's request and are maintained by the CSL. The Condor Team uses the usual channels to communicate with the CSL when this configuration needs changing.
+configurations. They were set up by the CSL at the Condor Team's request and are maintained by the CSL. The Condor Team uses the usual channels to communicate with the CSL when this configuration needs changing. There should
+be nothing surprising or confidential in this configuration.
 
 {code}
 [condor-yum-development]
@@ -27,8 +31,8 @@
 gid=nobody
 {endcode}
 
-{section: Mirror Site Actions}
-Once the mirror has happened, this is what the mirroring site needs to do. These changes allow YUM requests against the mirror to get the right files from the right place.
+{subsection: Mirror Site Actions}
+Once the mirror has happened at a site, this is what the mirroring site needs to do. These changes allow YUM requests against the mirror site to get the right files from the right place.
 
 {verbatim}
 1. Modify URL (baseurl) in each repo file to match the new location.
@@ -48,6 +52,6 @@
 
 {endverbatim}
 
-{section: Groups Known to Mirror the YUM repo}
+{subsection: Collaborators known to mirror the Condor YUM repository}
 
 *: LIGO