On Mar 31, 2005 3:00 PM, Duncan Lithgow <duncan@xxxxxxxxxxxxxxxxxx> wrote: > Hi Gustavo, I see we've both ended up on this list after working on that > guide. :-) > > One immediate option that might make sense is to use the Wiki at > > fedoraproject.org. This works if the document is still in flux > > somewhat. Then it has an official-looking URL, and the others can > > mirror that. > > > However, if it's solid and not likely to get as many edits, then it > > seems to me like a perfect document for fedora.redhat.com/docs. > > How about we do both? Make a permanant link for this version and stop > calling it a draft - call it version 1. And another wiki version > ready for any later changes? > > > http://fedora.redhat.com/participate/documentation-quick-start/ > > > > We can get a writer to help with the conversion to DocBook and to get > > the author/maintainer started. Of course, the list is here to help with > > ongoing learning of DocBook, writing, etc. > I would love to put it into DocBook, I've used XMLmind for DcoBook > before and would love to start using am Opensource app. I'll read the > quick-start guide over the weekend. > > Duncan > On second thougth... I was wondering. The suggestions we've made, like having a link on the sig, welcoming e-mail, etc. all imply the existence of *one* permanent link, and that is unique and stable. So, I believe that there should be only one version of it. The question now comes to which form to adopt: DocBook or Wiki? Based on maturity, since this document has gone through 4 draft versions, all discussed openly in the list, I believe it is mature enough to get the DocBook format. It would also give it a more "official" look. However, it seems to me, the DocBook is a more closed format, with more restrict access. On the other hand, being a community born document, maybe the Wiki is more appropriate, by giving it a more open character. On the weak side, the Wiki would have less of an "official" impact. I think both formats have their pros and cons. What's your opinion about it? -- ------------------------------------------------------------------ Gustavo Seabra Graduate Student Chemistry Dept. Kansas State University Registered Linux user number 381680 ------------------------------------------------------------------ If at first you don't succeed... ...skydiving is not for you.
