Thanks for starting this FAQ. On Wed, Nov 12, 2003 at 01:44:18PM -0800, Karsten Wade wrote: > All: > > It looks like we have some regular questions on this list. If we can > gather together some questions and answers, perhaps Tammy can post a FAQ > on fedora.redhat.com, and/or we can include the FAQ in the Mailman > "Welcome" email. I'm happy to maintain it for now. > > Below is what I've thought of so far. Let's use this thread to gather > the questions and answers. These are my proposed answers, please feel > free to "fix" them: > > ## begin FAQ (draft) ## > > Does Fedora Project need writers/editors? > > Yes! Writers are needed right now more then editors, until we have > something to edit. > > > What documents does FP need? > > FP documents are going to be of the tutorial/HOWTO variety. This is > the most useful information we can gather at this time, and it works > well with the distributed project. > > In the future, if small teams want to work on larger works similar > to the manuals for Red Hat products, we can work on adding that in. > > I would rather stick to tutorials with the exception of the Installation Guide for now. > How is the docs project organized? > > Rather loosely right now. Tammy Fox (tfox@xxxxxxxxxx) is the > project leader. It has been proposed that translators can work in > teams by languages. > > We may want to organize so that every writer has two-editors, and > contributors can work in either or both roles. This makes for a > more cumbersome process, but the quality control is higher. > > > What is the process/procedure for translating documents? > > There is currently no defined process. We are waiting for the > participation of the ever-busy Red Hat docs translation team. > > > What are PO files? > > PO files are textual, editable files used in translation. > http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC7 > > > What are some of the tutorial/HOWTOs currently proposed? > > From the mailing list: > > * Installing an SSH server with public/private key authentication > * Configuring and using digital cameras > > I have a bigger list I will send out shortly. > Can I translate the legal notice? > > The legal notice page can be translated, but a statement that the > translation is provided for convenience only and that the English > language version takes precedence must be on the top of the page. > > > What are the tools for writing documents? > > http://fedora.redhat.com/projects/docs details how to get the > Documentation Guide source and tools. The toolchain is explained on > that page, with the exception of PO files (see What are PO files?). > > Currently, there is a problem with PDF production (refer to > https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=104983). If > you have TeX experience and can help us resolve that one, please > dive in! > > > I have a tutorial in HTML, how do I convert it to DocBook? > > Grab html2db from http://www.cise.ufl.edu/~ppadala/tidy/ . > > > What are some resources for learning DocBook? > > The definitive DocBook reference written and maintained by Norm > Walsh is available at http://docbook.org/tdg/en/html/docbook.html . > > A combination tutorial and reference book is available at > http://www.sagehill.net/docbookxsl/index.html > > > Can I have CVS write access? > > Eventually, we intend for full contributors to have write access to > CVS, as well as access to other build environments. This is being > worked out across the entire Fedora Project. In the meantime, you > can contact the docs project leader Tammy Fox (tfox@xxxxxxxxxx) with > your changes. > > > What else is can I do to help? > > Have ideas for admonition graphics? > > ## 30 ## > -- > Karsten Wade : Tech Writer, RHCE : o: +1.831.466.9664 > kwade@xxxxxxxxxx : http://rhea.redhat.com/ : c: +1.831.818.9995 > Red Hat Enterprise Applications : WAF, CMS, Portal Server > -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- > > > -- > > fedora-docs-list@xxxxxxxxxx > http://www.redhat.com/mailman/listinfo/fedora-docs-list
