GlassFish v3 Community Docs Meeting July 30, 2009

Attendees

Chris Donaldson, Devika, Ian, June, Kim, Mike, Paul

Agenda

1. Confusion Over Differences Between Various GlassFish Releases
2. Review of AIs
3. Progress on writing assignments by feature
4. Bug status
5. Open mic
6. Next meeting

Minutes

1. Confusion Over Differences Between Various GlassFish Releases
   • Chris Donaldson, of Sun's Premium Support team raised an issue that some community members have raised in the GlassFish discussion forums: poor visibility of information about the differencess between GlassFish 2.1, GlassFish v3 Prelude, and GlassFish v3 Preview.
   • Some users have downloaded GlassFish v3 Prelude, only to be disappointed to discover that many features of a Java-EE-compliant application server are missing. While information that could have prevented this disappointment is available, users missed this information and selected to download and install a version that was unsuitable for their needs.
   • There was some acknowledgement that this issue is in part a result of the strategy for developing and marketing these different releases of GlassFish Application Server simultaneously.
   • The following suggestions for making these differences more apparent were made:
     • On the GlassFish downloads page, make these chages:
       • State the features and limitations of GlassFish v3 Prelude (provides early adopters the chance to try out modularity and extensibility, supports only Java EE 5, supports only the web tier, offers time-limited commercial support) and GlassFish v3 Preview (previews Java EE 6, offers no commercial support).
       • Move the Final Release section above the Work in Progress Section.
       • Add a table that compares features of the various GlassFish Application Server.
       • Near the download button for v3 Prelude, add a visually prominent statement of the limitations of the release.
     • In the Sun GlassFish Enterprise Server v3 Prelude Release Notes, add a level-1 section whose title states: This Release Supports Java EE 5.
   • If any changes are made, Chris agreed to use the discussion forums to discuss the changes with the community and report back.
     • New AI on Paul:* Contact Gail about updates to the GlassFish project webset to alleviate user confusion about the differences between the various releases of GlassFish Application Server.
2. Review of AIs:
   • • 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.
       In progress. Most of the man pages for commands with -properties have no detailed information about properties. Paul to investigate further.
     • 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.
       In progress. Paul has started reading the spec and has asked Rajeshwar about the using the HTTP interfaces for monitoring as described in Rajeshwar's blog. Paul has also met Rajeshwar and discussed the usage of this feature and what the documentation for this feature should explain. To do: write up results of discussion and report back.
     • 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.
       __Not Started.
3. Progress on writing assignments by feature
   No detailed discussion.
4. Bug status
   • Too early in the cycle to be tracking these individually.
   • Check the list and try to fix your bugs as you work on your docs.
5. Next meeting
   Thursday August 6th, 2009, 2-3 PM PDT