fedora-list guidelines

[Gustavo Seabra]

On Mar 31, 2005 3:00 PM, Duncan Lithgow <duncan at lithgow-schmidt.dk> 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.