docs/159897: [patch] improve HAST section of Handbook

[Warren Block]

The following reply was made to PR docs/159897; it has been noted by GNATS.

From: Warren Block <wblock at wonkity.com>
To: Benjamin Kaduk <kaduk at mit.edu>
Cc: freebsd-gnats-submit at freebsd.org, freebsd-doc at freebsd.org
Subject: Re: docs/159897: [patch] improve HAST section of Handbook
Date: Sun, 21 Aug 2011 08:43:53 -0600 (MDT)

 On Sat, 20 Aug 2011, Benjamin Kaduk wrote:
 
 > On Thu, 18 Aug 2011, Warren Block wrote:
 >
 >> -	  <para>File system agnostic, thus allowing to use any file
 >> +	  <para>File system agnostic, thus allowing use of any file
 >
 > I think "allowing the use" is better here.
 
 "allowing any" might be even better.
 
 >>       <para>Once the <acronym>HAST</acronym> framework is configured
 >> 	properly, the final step is to make sure that
 >> -	<acronym>HAST</acronym> is started during the system boot time
 >> -	automatically.  The following line should be added to the
 >> -	<filename>/etc/rc.conf</filename> file:</para>
 >> +	<acronym>HAST</acronym> is started automatically during the system
 >> +	boot.  This line is added to
 >> +	<filename>/etc/rc.conf</filename>:</para>
 >
 > "This line is added" is a pretty unusual grammatical construct for what is 
 > attempting to be conveyed.  "To do so, add this line to" I think says things 
 > more clearly.
 
 I would prefer the imperative "Add this line to...".
 
 >> -	<para>In order to fix this situation the administrator has to
 >> +	<para>The administrator must
 >> 	  decide which node has more important changes (or merge them
 >> -	  manually) and let the <acronym>HAST</acronym> perform
 >> +	  manually) and let <acronym>HAST</acronym> perform
 >> 	  the full synchronization of the node which has the broken
 >
 > Just "full synchronization", I think.
 
 Changing "of" to "on" ("full synchronization on the node") also helps a 
 bit.