atom feed7 messages in org.freebsd.freebsd-docRe: New Handbook Section for Review -...
FromSent OnAttachments
Daniel GerzoJan 31, 2012 2:49 am.diff
Benedict ReuschlingJan 31, 2012 12:37 pm 
Warren BlockJan 31, 2012 12:58 pm.diff
Niclas ZeisingJan 31, 2012 1:04 pm 
Warren BlockJan 31, 2012 1:07 pm 
Daniel GerzoFeb 5, 2012 4:11 am 
Warren BlockFeb 5, 2012 7:41 am 
Subject:Re: New Handbook Section for Review - graid3
From:Benedict Reuschling (bc@FreeBSD.org)
Date:Jan 31, 2012 12:37:59 pm
List:org.freebsd.freebsd-doc

-----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-----