On Mar 31, 2005 3:00 PM, Duncan Lithgow <duncan(a)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.