GlassFish Server Open Source Edition 3.1 Documentation Plan

Related Information

Feature Documentation Plans

Documentation Information

Engineering Information

Technical Writing Staff

Name Location Time Zone Role
Paul Davies Santa Clara, CA, USA US/Pacific Documentation project lead, writer
Mike Fitch Santa Clara, CA, USA US/Pacific Writer
Rebecca Parks Santa Clara, CA, USA US/Pacific Writer
Scott Fordin Burlington, MA, USA US/Eastern Writer

Summary of Deliverables

GlassFish Server Books

GlassFish Server books are distributed through the web.

For the 3.1 release, the books that are to be provided are listed in the following table.

The full title of each book is as follows:

GlassFish Server Open Source Edition 3.1 abbreviated-title

abbreviated-title is the abbreviated title as listed in the table.

Example book titles:

  • GlassFish Server Open Source Edition 3.1 Release Notes
  • GlassFish Server Open Source Edition 3.1 Deployment Guide
  • GlassFish Server Open Source Edition 3.1 Add-On Component Development Guide
Abbreviated Title Owner Short Name Part Number
Release Notes   SJSASEERN  
Quick Start Guide   SJSASEEQSG  
Installation Guide   SJSASEEIG  
Administration Guide   SJSASEEAG  
Application Deployment Guide   SJSASEEADG  
Security Guide      
Application Development Guide   SJSASEEDG  
Add-On Component Development Guide   SGFESADDONDEV  
Embedded Server Guide   GFEMBEDDED  
Troubleshooting Guide   SJSASEETSG  
Reference Manual   SJSASEEREFMAN  
Domain File Format Reference   SJSASEEAREF  
Upgrade Guide   SJSASEEUMG  
Error Message Reference   SJSASEEERR  
High Availability Administration Guide   SJSASEEHAAG  
Deployment Planning Guide   SJSASEEDPG  
Performance Tuning Guide   SJSASEEPTG  

Message Queue Books

Message Queue books are distributed through the web.

For the 3.1 release, the Message Queue books that are to be provided are listed in the following table.

Abbreviated Title Owner Short Name Part Number
Release Notes   MQRN  
Technical Overview   MQTO  
Administration Guide   MQAG  
Developer's Guide for JMX Clients   MQJMX  
Developer's Guide for Java Clients   MQDGJ  
Developer's Guide for C Clients   MQDGC  

Online Help Sets

Brief Title Owner Short Name Part Number Module ID
Administration Console Common Online Help   ASEEADCONOH   common
Administration Console JavaMail Online Help   ASEEACOHJMAIL   jmail
Administration Console Web Online Help   ASEEACOHWEB   web
Administration Console JDBC Online Help   ASEEACOHJDBC   jdbc
Administration Console JCA Online Help   ASEEACOHJCA   jca
Administration Console EJB Lite Online Help   ASEEACOHEJBLT   ejb-lite
Administration Console EJB Online Help   ASEEACOHEJB   ejb
Administration Console CORBA Online Help   ASEEACOHCORBA   corba
Administration Console JTS Online Help   ASEEACOHJTS   jts
Administration Console JMS Online Help   ASEEACOHJMS   jms
Upgrade Tool Online Help   SJSASEEMTOH   -
asadmin CLI help   - - -

Man Pages

Paul is responsible for delivery of man pages into Application Server builds. Owners of individual man pages are listed in the GlassFish 3.1 Man Page Document Plan.

Inline Help and System Texts

Properties File Owner
Strings.properties  

Bundled HTML Pages

Title Owner File Name
Quick Start for Basic Features 1   quickstart.html
GlassFish Server - Installation Complete   about.html
Proprietary Rights Notice   copyright.html
Features and Resources   features.html
Your Application Server is now running   index.html
  1. Generated from the book.

Documentation Change Requests

Defects
Tasks
RFEs
All
All bundled defects
All bundled tasks
All bundled RFEs
All bundled CRs
All unbundled defects All unbundled tasks All unbundled RFEs All unbundled CRs
All Defects
All Tasks
All RFEs
All CRs

Schedule

Milestone Date
Feature Doc Plans Complete July 30 2010
Soft code freeze (SCF) September 13 2010
Bundled documentation review start  
Bundled documentation review end  
Bundled documentation freeze  
Hard code freeze (HCF) November 22 2010
Unbundled documentation review start  
Unbundled documentation review end  
Delivery of unbundled documents  
Publication of unbundled documents  
Go/no go December 14 2010

Bundled documentation consists of documentation that is bundled with the product, namely:

  • Online help
  • Inline help and system texts
  • Man pages
  • Bundled HTML pages

Unbundled documentation consists of the books, which are published on the web separately from the product.

Deliverables That Are to Be Translated

  • Online help sets for the Administration Console
  • asadmin CLI help
  • Inline help and system texts

Documentation Exit Criteria

  • All planned documentation deliverables present and complete 1 .
  • No unwaived P1, P2, or P3 bugs.
  1. The scope of a document deliverable might be cut to meet the schedule. The technical writers will work with the engineers to determine which topics are the highest priority.