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