Re: [opensuse] mdadm man page is bad too

On Sat, 12 Apr 2014 12:21:16 jdebert wrote:

On Sat, 12 Apr 2014 19:17:00 +0200 (CEST) Istvan Gabor wrote:

...

This is not an openSUSE issue I guess. Not only the manual but the mdadm/mdraid wiki site (https://raid.wiki.kernel.org/index.php/RAID_setup) is puzzling too. They say there is a raid-howto but it is obsolete and the wiki pages are cecommended. The wiki site is very badly organized, definitely hard to use for a begginer to raid configuration and setup.

(rant redacted)

Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right.

jd

People who write the code don't need the documentation, and some seem to expect everyone else to be able to figure it out by reading the source code... -- ============================================================== Rodney Baker VK5ZTV rodney.baker@iinet.net.au ============================================================== -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org