On Thu, 2005-04-21 at 11:04 -0500, Eric Rostetter wrote: > Quoting gaurav <gauravp@xxxxxxxxxxxxxxx>: > > > Hi List, > > Howdy. I just recently joined the list, since I'm doing the web/docs > for the Fedora Legacy Project... > > > I was wondering why this documentation submition process is > > overly complex... > > While I agree it is very complex, I also like it. I think it will produce > commercial quality docs, if enough people participate. I think that is > the goal of it. Hear, hear, Eric! I am a big fan of the Red Hat official documentation. I didn't find it early enough to learn from it when I first got started with Linux, but later I found that it filled in *a lot* of the holes in my knowledge of the software. I began to point new users to it, and found that often they would drop me a personal email later to tell me how helpful the docs were -- which was funny because I had no part in them myself, only enjoyed them as a reader. My personal goal is that, in the future, thousands of people will get the same benefits from FDP documentation. I want the same high standards of quality for all our work here, and I have no doubt it will pay off over time. There are many places on the Web to find answers, but very few, if any, produce that kind of consistency of quality and comprehensiveness. > > why don t we we use some wiki like tikiwiki or media > > wiki (of webopedia fame) to manage documents > > The best use of the wiki is to create the initial docs, which can be > done with lots of colaboration and community input. At that point, the > wiki doc can then be converted to DocBook, checked for accuracy and > so on, and submitted. I think this would be the ultimate solution: > multiple people help create the doc, someone then distills that into > the proper format, the editors then verify it and make any corrections > needed, and it is published meeting all the standards. > > > ...why I am required to > > submit docs in docbook xml format ....and check into cvs ....then built > > it ....., > > I think that someone is required to do this, not neccessarily you. > You can always create a doc in some other way, and then find someone > else to convert it to docbook and put it in cvs. > > > most wiki system have have built in work flow, revision > > mechanism, doc conversion to pdf and tons of other stuff etc > > ...........what is the requirement or need for such complexity ... > > That I can't answer. But, maybe I've suggested a way to work around > the requirments and still participate? Others have successfully done the same. I keep my drafts on my own server for people to look at and comment on. I just recently put a Wikimedia/Wikipedia wiki up and may use that in the future... these are all good choices. I think we have only asked people to put something prominently on each page showing that it's not official documentation yet. Dig the archives for more information, or maybe someone here has the text they used. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list@xxxxxxxxxx To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-docs-list
