GlassFish v3 Documentation Planning Minutes - 4/17/08

Main meetings page

Attendees

Paul, Hanan, Gail, June, Alan, Scott, Debbie

Agenda

  1. Review of AIs - Paul
  2. Status of Glass Fish v3 User Task Analyses - Paul
  3. Status of deliverables
  4. Quality improvement measures for the v3 doc set
  5. Open mic - All
  6. Next meeting - All
    \

Meeting Notes

1. Review of AIs - Paul

    • Paul:* Investigate how Update Center 2.0 will work for v3. NO PROGRESS - SOON (needs info for the Release Notes)
    • June:* Contact Groovy and Grails SMEs and schedule the TA session. NO PROGRESS
    • Paul:* Doublecheck the validity of assumptions about Grizzly before eliminating the TA altogether. NO PROGRESS
    • Paul:* Determine when TP2 unbundled deliverables are actually due. SOME PROGRESS (probably due around May 1st)
    • Paul:* Create a wiki page and add ideas to it for quality improvement measures for the v3 doc set. NO PROGRESS
      \

Suspended AIs

    • Paul:* Start a SolBook rules page.
    • June and others:* Contribute to the SolBook rules page.
    • Paul:* Change the description of the process so it highlights that you also need to identify where the tasks will be documented.
    • Paul:* Find out if TP2 is going to be turned into an FCS-quality developer release.
    • Paul:* Determine whether the modularity of GlassFish v3 necessitates modular documentation for GlassFish v3.
      \

2. Status of Glass Fish v3 User Task Analyses - Paul
Standing agenda item; no updates this week.
\

3. Status of deliverables:

    • Release Notes - Paul:* In progress; hopes to have draft out by 4/18
    • Quick Start Guide book and HTML - Scott:* 6th draft out for review; received a few minor comments; scripting story needs work; mostly done except for a few links that are TBD
    • Quick Start Guide screencast - Scott:* Starting on screen captures for the screencast
    • Administration Guide - Dixie:* Not in attendance; draft sent out for review 4/16
    • Developer's Guide - June:* Making progress; surprised about the number of classloader changes in TP2 (discovered via Tech Talk)
    • Application Deployment Guide - June:* Working on it; guide has become very short
    • Man Pages - Paul:* TP2 man pages done; delivered into build on 4/15; built the book and checked it in to PubsTool
    • RESTful Web Services Developer's Guide - Debbie:* Should be out for review by 4/21
    • jMaki Application Developer's Guide - Jennifer:* Not in attendance; update via e-mail: going fine, out for review
    • jRuby Application Developer's Guide - Jennifer:* Not in attendance; update via e-mail: going fine, out for review
    • Admin GUI Console Online Help - Paul/Hanan:* Hanan handed the Help off; it got checked in; she reorganized the Help and commented out content that's not for TP2; continues to work on improvements even though those changes will most likely not go into TP2
    • Bundled HTML Pages - Paul:* Done
    • GlassFish v3 Technology Preview Welcome Page - Gail:* Holding off on this until the other pieces/pointers are in place; this is a wiki page so it should be fairly easy to create; actual page creation will take place at the end of April
    • GlassFish v3 Technology Preview 2 Installation Guide - Chinmayee:* Not in attendance; no update
    • GlassFish v3 Technology Preview 2 Rodamap to the Java EE Tutorial - Ian:* Not in attendance; no update
    • GlassFish User FAQ - Gail:* Work not yet underway; will start later this month; send FAQ ideas if you have them
    • GlassFish Developer FAQ - Gail:* Work not yet underway; will start later this month; send FAQ ideas if you have them
      \

4. Quality improvement measures for the v3 doc set
Discussion about this will resume once the related wiki page is in place.
\

5. Open mic - All

  • Please update Link Manager with contents of your books so other writers can link to them.
  • Admin Console still says Sun Java System instead of GlassFish; this is wrong, engineering knows about it, and conversations are underway about getting it fixed; be aware of this for TP2 deliverables
    \

6. Next meeting - All
Thursday 4/24 3-4 PM PDT
Main meetings page