docs/124716: Geom RAID1 handbook example only covers boot partition

[Hywel Mallett]

>Number:         124716
>Category:       docs
>Synopsis:       Geom RAID1 handbook example only covers boot partition
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 18 14:10:02 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Hywel Mallett
>Release:        
>Organization:
>Environment:
>Description:
In the handbook the section on RAID0 is very clear, and gives a good example of how to configure a new RAID0 array and newfs it. This section assumes that the new array is an additional array to be added to /etc/fstab.
By contrast the section on RAID1 assumes that you want a mirrored root partition on a newly-installed system. The extra complexities mean that the section is confusing to a beginner.
>How-To-Repeat:

>Fix:
Move the existing RAID1 section to a new section - "How to mirror your boot partition" (or similar).
Create a new RAID1 section covering how to add a RAID1 array as an additional filesystem, in the same vein as the current RAID0 section.

>Release-Note:
>Audit-Trail:
>Unformatted: