New Handbook Section for Review - graid3

[Benedict Reuschling]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 31.01.12 11:49, schrieb Daniel Gerzo:
> Hello everybody,
> 
>   A new Handbook section covering graid3 is now available for review;
>   the patch is attached.
> 
>   The text is based on PR 164228. A built version is available at
>   http://people.freebsd.org/~danger/geom-raid3.html.
> 
>   Comments are welcome.
> 

Hello Daniel,

thanks for doing the work on this PR. I've reviewed the patch. Overall,
it looks good, but I would enhance the following section a bit:

+    <sect2>
+      <title>Creating Dedicated <acronym>RAID</acronym>3 Array</title>

I would write "Creating A Dedicated <acronym>RAID</acronym>3 Array"
since it is also mentioned in the text like this.

+      <note>
+	<para>While it is theoretically possible to boot from
+	  <acronym>RAID</acronym>3 array on &os;, such configuration
+	  is not common and is not advised.  As such, this section
+	  does not provide description of how to accomplish such
+	  configuration.</para>
+      </note>

How about reducing the "such" word count in the last sentence? How about
"... of how to accomplish this kind of configuration." or "... this type
of configuration." ?

Regards

Benedict Reuschling
FreeBSD Documentation Committer

The FreeBSD Documentation Project
FreeBSD German Documentation Project - https://doc.bsdgroup.de
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.8 (Darwin)
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk8oUUUACgkQTSZQLkqBk0iWpACfaZMRtE7qd1KJUQqYdDxYlI8L
MIgAnRWT6Jx2DUz6EvzpkMOpQ3RYIHvU
=qPM7
-----END PGP SIGNATURE-----