summary page for process workflow?

[Jonathan Gibbons]

A workflow diagram sounds useful but different.  It's good detail for 
the person
trying to navigate through the process, to figure out what to do next when
something goes wrong.

For my part, a quick reference guide is useful, more details than a flow 
chart,
but less detailed than multiple pages of info.  I've been developing  
one for
myself and other compiler folk. Having it be hyperlinked into more 
detailed pages
would be good. I'll attach the one I've been using for myself, as an 
example.
Obviously, this one is specific to the compiler team, but you get the idea.

-- Jon

iris clark wrote:
> 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
>   

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20080305/1c9cb727/attachment.html 
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: jdk-check.txt
Url: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20080305/1c9cb727/attachment.txt