On Mon, 12 Jan 2004 18:41:42 -0700 (MST), Lucas Albers <[EMAIL PROTECTED]> posted to debian-doc: > http://www.cs.montana.edu/faq/faqw.admin.py?query=mdadm&querytype=simple&casefold=yes&req=search
The above URL provides a simple facility for making changes, but one needs a password. Is this something you encourage? Wouldn't it be better to move the whole thing to a public CVS (say, on Alioth)? I tried to make some changes but obviously didn't have the required password. Here are some suggestions: * Add a TODO section where you summarize things which still need to be done. * You refer to the sfdisk command which isn't standard; you should list prerequisites (i.e. the util-linux package, and perhaps others?) in the "Getting Started" section. * Break things up into hierarchical sections. What to do before, what to do during the upgrade, what to do after. Within those sections, further break up each step unless it's entirely trivial. * The HTML formatting needs a thorough overhaul. If you move the source to DocBook or DebianDoc, the formatting tools will take care of that for you, of course. In particular, the formatting of commands is IMHO a bit confusing and unclear. Fixed-width type is pretty much the standard when quoting command lines. Also subheads, indentation levels etc. (which would follow from the previous suggestion) could help make the document easier to read. * s/easier then/easier than/ * s%dev/had%dev/hda% * Punctuation and paragraph divisions are somewhat erratic in places, but perhaps you should work on the overall layout -- and perhaps choose a more author-friendly format -- before tackling these details. Hope this helps, /* era */ -- formail -s procmail <http://www.iki.fi/era/spam/ >http://www.euro.cauce.org/ cat | more | cat<http://www.iki.fi/era/unix/award.html>http://www.debian.org/
