Yes, there is undoubtedly room for improving the documentation. Suggestions are alway welcome.
Both --raid-disks and --raid-devices are accepted by mdadm. Maybe this should be made clearer?
I have updated the --help text for --grow. The new text will be in 2.6.1. Thanks.
