more defined process

[Karsten Wade]

On Fri, 2004-08-13 at 17:00, Tammy Fox wrote:
> On Fri, 2004-08-13 at 16:12, Karsten Wade wrote:

> > I think a person can fill both roles, depending on what he or she is
> > doing.  Unless there is a compelling reason not to, I'd suggest
> > mentioning that you can fill both roles, but it's easier to fill just
> > one to start.
> > 
> 
> True. A person just can't be both the writer and the editor on the same
> document.

Oh, definitely not.  I meant, same roles in the project overall.  For
example, we could edit each other's documents.  This is a good
collaboration technique.

> > * For now, we will take initial submissions in other formats and
> > volunteers will do the conversion to DocBook.  This is on a case-by-case
> > basis.
> > 
> > * If the document is going to be maintained, and you are the maintainer,
> > you must be willing to learn enough DocBook to maintain your document.
> > 
> 
> I have found that once someone sees their own document in DocBook it
> helps them learn it themselves.

Ah, yes, you understand. :)

This is an important thing to put up front in the Quick Intro[1]:  you
don't have to know DocBook to start a document.  This removes a
perceived barrier to entry.

Give me a few days to turn the process document back around that came
out of the discussion this week.  It's in DocBook and I'm doing a style
edit plus adding a few items that came up this week.

- Karsten
[1] 
I Tammy's piece could have a name like Quick Introduction to How to be a
Fedora Writer, aka Quick Intro.

For Mark's, I was leaning toward Quick Start to Fedora Documentation
Project:  Tools for Fools ... something like that ... aka Quick Start.

--
Karsten Wade, RHCE, Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115  5F1B D992 0E06 AD0E 0C41