summary page for process workflow?

[iris clark]

Hi, Jon.

> The Guide currently has the potential for a lot of detail about the  
> process workflow, spread over many pages.  It would also be nice to  
> have a shorter summary "checklist" page, particularly for all the  
> steps to get code back into a repository once you have prepared the  
> new code. There's a lot of steps there: test, get approvals (CCC,  
> Core), review, fix white space, create putback message, update  
> repository (i.e. pull), create changeset, deal with conflicts, and  
> finally, push. Phew.

Fantastic idea!  As you say, there's quite a bit of text and I don't
expect that people are going to want to read it often.  I was hoping
that the "Process Workflow" section [TBD] with associated diagrams
would address most of this problem:

  http://openjdk.java.net/guide/processWorkflow.html

But also I really like the idea of having up-to-date checklist(s?)
which reference the more detailed portions of the guide as necessary.
I could also see some kind of "Quick Reference Guide".  

Do you have an initial list we can start with?  From your message, I'm
seeing something like this:

  - test
  - get approvals (CCC, Core)
  - review
  - fix white space
  - create putback message
  - update  repository (i.e. pull)
  - create changeset
  - deal with conflicts,
  - push

I know that they don't exist yet, but is this checklist just another
representation for the Process Workflow diagrams?

Thanks,
iris