GlassFish v3 Community Docs Meeting August 20, 2009

Attendees

Dixie, Gail, June, Kim, Mike, Paul

Agenda

1. Review of AIs
2. Progress on writing assignments by feature
3. Bug status
4. Open mic
5. Next meeting

Minutes

1. Review of AIs
   Discussed the following:
   • • Paul:* Cross-check the v3 list of functional specifications against the list of features in the v2 documentation.
       In progress. Paul is awaiting response from Abhijit.
     • Paul:* Verify EOL process for features that are marked as "Never".
       In progress. Paul is awaiting response from Abhijit.
     • Paul:* Look at the man pages to see what properties are already doc'd there.
       Complete. The list of properties to be documented has been added to the Properties Documentation Plan. Thanks to Kim and June for their help with this.
     • Paul:* Determine the URL to API docs for the GlassFish packages and update Prefaces accordingly.
       In progress. Paul is awaiting response from Jane Young.
     • Paul:* Read the HTTP Interface for Administration spec, speak with Rajeshwar, and report back.
       __Complete.
     • All by August 13, 2009:* Read the functional specification for each of your features and send to Paul any new man pages introduced by the feature that are not listed in the Administration CLI Documentation Plan.
       Overdue.
     • Paul:* Contact Gail about updates to the GlassFish project web site to alleviate user confusion about the differences between the various releases of GlassFish Application Server.
       Complete.
2. Progress on writing assignments by feature
   • General discussion.
3. Bug status
   • Not discussed in detail.
4. Open mic
   • GlassFish v3 schedule has been changed and published. Put back changes by COB Friday Aug 21 for any man pages you want included in the Aug 24 Soft Code Freeze (SCF) build.
   • Discussed bundled Quick Start Guide and inclusion in SCF build. Due to the logistics of getting it into the build, will not include latest version for SCF.
   • Discussed how to document default values in the Domain File Format Reference. In some cases the values in domain.xml are different from the system defaults and may override the system defaults. If a value is removed from domain.xml and the system restarted, the system reverts to the system defaults. June will list values in domain.xml as the defaults but in the description indicate that the system default is different.
5. Next meeting
   Thursday August 27, 2009, 2-3 PM PDT

Main meetings page