* documentation @ 2011-01-31 21:39 Roberto Spadim 2011-01-31 21:43 ` documentation Mathias Burén 2011-01-31 21:58 ` documentation NeilBrown 0 siblings, 2 replies; 6+ messages in thread From: Roberto Spadim @ 2011-01-31 21:39 UTC (permalink / raw) To: Linux-RAID hi guys, where´s 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´s the most updated (official)? -- Roberto Spadim Spadim Technology / SPAEmpresarial -- 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 http://vger.kernel.org/majordomo-info.html ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation 2011-01-31 21:39 documentation Roberto Spadim @ 2011-01-31 21:43 ` Mathias Burén 2011-01-31 21:58 ` documentation NeilBrown 1 sibling, 0 replies; 6+ messages in thread From: Mathias Burén @ 2011-01-31 21:43 UTC (permalink / raw) To: Roberto Spadim; +Cc: Linux-RAID On 31 January 2011 21:39, Roberto Spadim <roberto@spadim.com.br> wrote: > hi guys, where´s 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´s the most updated (official)? > > -- > Roberto Spadim > Spadim Technology / SPAEmpresarial > -- > 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 http://vger.kernel.org/majordomo-info.html > http://neil.brown.name/blog/mdadm has info. // Mathias -- 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 http://vger.kernel.org/majordomo-info.html ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation 2011-01-31 21:39 documentation Roberto Spadim 2011-01-31 21:43 ` documentation Mathias Burén @ 2011-01-31 21:58 ` NeilBrown 2011-01-31 22:14 ` documentation Roberto Spadim 1 sibling, 1 reply; 6+ messages in thread From: NeilBrown @ 2011-01-31 21:58 UTC (permalink / raw) To: Roberto Spadim; +Cc: Linux-RAID On Mon, 31 Jan 2011 19:39:03 -0200 Roberto Spadim <roberto@spadim.com.br> wrote: > hi guys, where´s 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´s the most updated (official)? > "official" has always struck me as a rather strange term in this sort of context. It implies that there is an 'office' which the 'official' holds. I wonder what this 'office' is.... However to be useful instead of philosophical: - the source code is the definitive documentation. However few people can read it very well. - the man pages in the mdadm package are the formal documentation that I am most likely to update in anything close to a timely manner. In particular man 4 md is worth a read. - An archive of this mailing line (linux-raid) is likely to be the best informal source of documentation. It contains lots of valuable information, but of course is not structured very well. - https://linux-raid.wiki.kernel.org/ is a community-maintained wiki which should be reasonably reliable. (that is the same location as the link that you found above). - the doco in the kernel (Documentation/md.txt) is hardly ever updated and so is probably badly out of date. Sorry. - As has been mentioned, http://neil.brown.name/blog/mdadm and http://neil.brown.name/blog/SoftRaid sometimes contain useful information but I don't write as often as I would like to. - This is a Book: Managing RAID on Linux http://oreilly.com/catalog/9781565927308/index.html?CMP=IL7015 however it is now about 8 years old, so it will be missing a lot of new 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 http://vger.kernel.org/majordomo-info.html ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation 2011-01-31 21:58 ` documentation NeilBrown @ 2011-01-31 22:14 ` Roberto Spadim 2011-02-01 9:37 ` documentation hansbkk 0 siblings, 1 reply; 6+ messages in thread From: Roberto Spadim @ 2011-01-31 22:14 UTC (permalink / raw) To: NeilBrown; +Cc: Linux-RAID nice =] could we put these information at (Documentation/md.txt) i didn´t read yet, but could we put there? hehehe if i don´t 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 .txt 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 <neilb@suse.de>: > On Mon, 31 Jan 2011 19:39:03 -0200 Roberto Spadim <roberto@spadim.com.br> > wrote: > >> hi guys, where´s 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´s the most updated (official)? >> > > "official" has always struck me as a rather strange term in this sort of > context. It implies that there is an 'office' which the 'official' holds. > I wonder what this 'office' is.... > > However to be useful instead of philosophical: > > - the source code is the definitive documentation. However few people can > read it very well. > - the man pages in the mdadm package are the formal documentation that I am > most likely to update in anything close to a timely manner. In particular > man 4 md > is worth a read. > - An archive of this mailing line (linux-raid) is likely to be the best > informal source of documentation. It contains lots of valuable > information, but of course is not structured very well. > - https://linux-raid.wiki.kernel.org/ is a community-maintained wiki which > should be reasonably reliable. (that is the same location as the link that > you found above). > - the doco in the kernel (Documentation/md.txt) is hardly ever updated and so > is probably badly out of date. Sorry. > - As has been mentioned, http://neil.brown.name/blog/mdadm and > http://neil.brown.name/blog/SoftRaid sometimes contain useful information > but I don't write as often as I would like to. > - This is a Book: Managing RAID on Linux > http://oreilly.com/catalog/9781565927308/index.html?CMP=IL7015 > however it is now about 8 years old, so it will be missing a lot of new > 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 http://vger.kernel.org/majordomo-info.html > -- Roberto Spadim Spadim Technology / SPAEmpresarial -- 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 http://vger.kernel.org/majordomo-info.html ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation 2011-01-31 22:14 ` documentation Roberto Spadim @ 2011-02-01 9:37 ` hansbkk 2011-02-01 13:49 ` documentation Roberto Spadim 0 siblings, 1 reply; 6+ messages in thread From: hansbkk @ 2011-02-01 9:37 UTC (permalink / raw) To: Roberto Spadim; +Cc: NeilBrown, Linux-RAID For others googling later, there's also good user-level intro information in SLES and RHEL's doc sets http://www.google.com/search?q=raid+site%3Adocs.redhat.com http://www.google.com/search?q=raid+site%3Awww.novell.com%2Fdocumentation Re the concept of "official" in the concept of open-source, to me it means the docs maintained by those who "own" the project. Otherwise, there is often a "canonical" central location maintained by the community, which although perhaps not complete nor kept up to date should at least point to the more authoritative sources for those learning about the topic. My two cents: I for one would vote for http://raid.wiki.kernel.org/ as this, and since Neil's time is better spent coding than updating user-level docs, those of us that would like to see better-maintained documentation should dig in and help create it. Of course whatever Neil can find the time to add at dev-tech levels is invaluable, and should at least be pointed to by the "official" wiki. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation 2011-02-01 9:37 ` documentation hansbkk @ 2011-02-01 13:49 ` Roberto Spadim 0 siblings, 0 replies; 6+ messages in thread From: Roberto Spadim @ 2011-02-01 13:49 UTC (permalink / raw) To: hansbkk; +Cc: NeilBrown, Linux-RAID nice! my vote to raid.wiki.kernel.org there´s links on wikipedia to it? linux source code documentation? 2011/2/1 <hansbkk@gmail.com>: > For others googling later, there's also good user-level intro > information in SLES and RHEL's doc sets > > http://www.google.com/search?q=raid+site%3Adocs.redhat.com > http://www.google.com/search?q=raid+site%3Awww.novell.com%2Fdocumentation > > Re the concept of "official" in the concept of open-source, to me it > means the docs maintained by those who "own" the project. > > Otherwise, there is often a "canonical" central location maintained by > the community, which although perhaps not complete nor kept up to date > should at least point to the more authoritative sources for those > learning about the topic. > > My two cents: I for one would vote for http://raid.wiki.kernel.org/ as > this, and since Neil's time is better spent coding than updating > user-level docs, those of us that would like to see better-maintained > documentation should dig in and help create it. Of course whatever > Neil can find the time to add at dev-tech levels is invaluable, and > should at least be pointed to by the "official" wiki. > -- > 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 http://vger.kernel.org/majordomo-info.html > -- Roberto Spadim Spadim Technology / SPAEmpresarial -- 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 http://vger.kernel.org/majordomo-info.html ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2011-02-01 13:49 UTC | newest] Thread overview: 6+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2011-01-31 21:39 documentation Roberto Spadim 2011-01-31 21:43 ` documentation Mathias Burén 2011-01-31 21:58 ` documentation NeilBrown 2011-01-31 22:14 ` documentation Roberto Spadim 2011-02-01 9:37 ` documentation hansbkk 2011-02-01 13:49 ` documentation Roberto Spadim
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).