workflow (was Progress report)

[Karsten Wade]

On Thu, 2004-10-14 at 13:56, Paul W. Frields wrote:
> On Thu, 2004-10-14 at 16:03, Tammy Fox wrote:
> > 
> > I set up 129722 for docs that were through the proof phase and were
> > ready to push live. So, technically, they aren't supposed to move there
> > yet. I would blame the docs, but I helped write them. ;-)
> 
> You can't blame them anyway, it was my fault. I went back and reviewed
> the Quick Start Guide again, and it does state that "once the writer and
> editor feel it is ready to be published to the website, make bug 129722
> depend on this bug so the project maintainer can review it and post it
> to the website." I didn't read carefully enough, so shame on me.

I've read this several times now, and I still get the same
interpretation.

1. Writer (Paul) and Editor (Karsten) think the doc is ready, so it gets
pushed to 129722

2. Web editor/maintainer (Tammy) continues workflow in 129722, doing a
final edit before publishing.

Isn't this what Paul did?

Now, if what Tammy -meant- was that 129722 was only for docs that are
totally edited, and literally just in the queue for inclusion on the
website, then we need to fix the docs to reflect that.

I think of this in terms of the roles and the workflow.  In the current
situation, Tammy is filling several roles, i.e., project maintainer, Web
maintainer, publication editor, etc.  Since these are roles, they can be
parsed into different people, and their actions are associated with
different phases in a document's lifecycle.

Below is a representation of the workflow, aiui.

In this situation, I completed the Editing phase and sent the documents
onto the Publication phase, which is represented in 129722.  In that
phase, if Tammy finds enough problems, she can send it back to me to
resolve as I see fit, or bounce it all the way back to the Writing
phase.  The latter wouldn't usually occur; minor edits can be done by
the publication editor, editor, or writer.

A different workflow, which is what I think Tammy is talking about,
would have two parts to the Editing phase, or just insert a Publication
Editing phase after the Editing phase.  So, it just comes down to where
we think the final-final edit/check-over should be in the workflow.

# Current Workflow

## Writing phase

Writer writes
Editor observes

## Editing phase

Editor edits, can send back to Writing phase or send on to Publication
phase

## Publication phase

Publication editor does a final read, approves or sends back to Editing
or Writing phases.

Web maintainer takes a document, only after it's been approved for
publication, and puts it on the site.  Any problems after that go
through a bug maintenance phase.

-- 
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