Re: Contact for managing Fedora documentation?

["David O'Brien" <davido redhat com>]

Karsten Wade wrote:
> On Wed, Jan 14, 2009 at 11:13:18AM +1000, David O'Brien wrote:
>   
> > Who's the best person to talk to about managing Fedora doc? Especially  
> > things like:
> > - how the community contributes
> > - reviewing community contributions
> > - sharing doc between Fedora and RHEL
> > - location/use of repos
> >
> > I've been having a look over the fedoraproject.org site, but still have  
> > some questions.
> >     
>
> Ask away; this is the Fedora Docs mailing list, couldn't be a better
> place to ask. :)
>
> Much of this may be on the wiki, but until we get our pages renamed
> and categorized, it's nearly impossible to find.
>
> - Karsten
>   
I'm working on a project that currently produces a community version and 
an Enterprise version of both the software and the documentation. The 
community version of the documentation is written and maintained on a 
wiki, and the Enterprise doc using DocBook xml. Being the only writer on 
the project means the community version of the doc is always out of date 
(I focus on Enterprise doc). This is a new project and community 
engagement is still developing. Maintaining both versions of the doc to 
keep up with the software is not possible for a single writer, and quite 
frankly not desirable. I'm researching how I might develop all of the 
doc in a single language (DocBook xml) and deliver it to both 
destinations using publican.

I found a bunch of info on the website about community contributions and 
the use of WikiText, OOo, plain text, etc., if they weren't comfortable 
with the idea of using xml. I'm looking into whether supporting 
contributions in a wide range of formats is feasible.

I didn't determine from what I read at what point contributions are 
reviewed. (I didn't read the whole site, of course, just looked for the 
important bits.) Are reviews performed on WikiText, converted DocBook, 
elsewhere? How do you determine who can review and approve docs? How do 
you manage docs that have been submitted, converted, and published? Are 
edits/updates performed in WikiText and reconverted?

What degree of sharing occurs between Fedora and RHEL documentation (if 
any)? How is this handled?

I found info on the cvs repo that's used.

As I read and learn more I might have more or different questions, or 
answer some of my own :)

thanks a lot.

--

David O'Brien
IPA Content Author
Red Hat Asia Pacific

"We couldn't care less about comfort. We make you feel good."
Federico Minoli CEO Ducati Motor S.p.A.