From mboxrd@z Thu Jan 1 00:00:00 1970 From: Roberto Spadim Subject: Re: documentation Date: Mon, 31 Jan 2011 20:14:12 -0200 Message-ID: References: <20110201085851.2b665f1a@notabene.brown> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: <20110201085851.2b665f1a@notabene.brown> Sender: linux-raid-owner@vger.kernel.org To: NeilBrown Cc: Linux-RAID List-Id: linux-raid.ids nice =3D] could we put these information at (Documentation/md.txt) i didn=B4t read yet, but could we put there? hehehe if i don=B4t have linux-raid@vger.kernel.org as a maillist i would read from there first, after wikipedia, and after try google... i think documentation at source code level is nice, a documentattion (.txt file) at linux source code, maybe is good, maybe not... maybe in future everythink is at wikipedia or kernel documentation or stay at =2Etxt file, the point is, a easy to find place (if only have source code: md.txt, if have internet google or wikipedia or yahoo or another search system) thanks neil! 2011/1/31 NeilBrown : > On Mon, 31 Jan 2011 19:39:03 -0200 Roberto Spadim > wrote: > >> hi guys, where=B4s the official documentation page (wiki)? is it at >> linux kernel source code? or at a wikipedia or another wiki page? >> i found this: >> http://www.linuxfoundation.org/collaborate/workgroups/linux-raid >> at wikipedia >> and some documentation inside kernel source code >> what=B4s the most updated (official)? >> > > "official" has always struck me as a rather strange term in this sort= of > context. =A0It implies that there is an 'office' which the 'official'= holds. > I wonder what this 'office' is.... > > However to be useful instead of philosophical: > > =A0- the source code is the definitive documentation. =A0However few = people can > =A0 read it very well. > =A0- the man pages in the mdadm package are the formal documentation = that I am > =A0 most likely to update in anything close to a timely manner. =A0In= particular > =A0 =A0 man 4 md > =A0 is worth a read. > =A0- An archive of this mailing line (linux-raid) is likely to be the= best > =A0 informal source of documentation. =A0It contains lots of valuable > =A0 information, but of course is not structured very well. > =A0- https://linux-raid.wiki.kernel.org/ is a community-maintained wi= ki which > =A0 should be reasonably reliable. (that is the same location as the = link that > =A0 you found above). > =A0- the doco in the kernel (Documentation/md.txt) is hardly ever upd= ated and so > =A0 is probably badly out of date. =A0Sorry. > =A0- As has been mentioned, http://neil.brown.name/blog/mdadm and > =A0 http://neil.brown.name/blog/SoftRaid sometimes contain useful inf= ormation > =A0 but I don't write as often as I would like to. > =A0- This is a Book: Managing RAID on Linux > =A0 =A0 http://oreilly.com/catalog/9781565927308/index.html?CMP=3DIL7= 015 > =A0 however it is now about 8 years old, so it will be missing a lot = of new > =A0 stuff. > > Hope that helps, > NeilBrown > -- > To unsubscribe from this list: send the line "unsubscribe linux-raid"= in > the body of a message to majordomo@vger.kernel.org > More majordomo info at =A0http://vger.kernel.org/majordomo-info.html > --=20 Roberto Spadim Spadim Technology / SPAEmpresarial -- To unsubscribe from this list: send the line "unsubscribe linux-raid" i= n the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html