Wednesday Feb 13, 2008

Brainstorming for GlassFish v3 User Tasks: Facilitating a Session

The final installment in the series explaining how to brainstorm for user tasks.[Read More]

Wednesday Feb 06, 2008

Brainstorming for GlassFish v3 User Tasks: Preparing to Facilitate a Session

A summary of the process for preparing to facilitate a task brainstorming session.[Read More]

And the Award for Best Documentation Goes To...

Oh, that's right. I can't win. But you can if you're not a Sun employee and if you meet a few other restrictions. Yes, it's true. Fame and fortune can be yours simply by writing documentation.

It's all part of the Community Innovation Awards Program, which is now open for submissions. GlassFish is one of the participating open source projects and monetary awards (money!) will be given in the categories of Bug Reports and Contributions. That Contributions category includes documentation. See the GlassFish Awards Program for complete details. The last day to submit entries is June 30th, 2008. Winners will be announced on or about August 15th, 2008.

Thursday Jan 31, 2008

Brainstorming for GlassFish v3 User Tasks: What and Who

A description of the process for identifying the scope of and key participants in task brainstorming sessions[Read More]

Friday Dec 21, 2007

Taking Stock of Docs: What Worked and What Didn't?

The end of the year is a good time to take stock: What worked, what didn't, what to focus on going forward.

The Application Server docs team tried some new things this past year and we'd like to know how you, our customers and documentation consumers, feel about them: What worked and what didn't?

A few items to consider:

  • Documentation Comments Wiki – Do you know about it? Did you use it? Was it helpful? The doc comments wiki is a great mechanism for providing feedback on the docs (and now we'd like feedback on the feedback mechanism!).

  • User and Developer FAQs – Did you use or contribute to either of these? Are they helpful? What would make them better? These FAQs are definitely a community effort, so if you have something to contribute, please do.

  • Documentation Mailing List – Are you on it? If not, why not join? If you're interested in documentation and in building the documentation community, this is great place to get the conversation started. You can join the list from the GlassFish mailing lists page. The page isn't in alphabetical order so you'll need to scroll way down (the infrastructure apparently orders the list based on age, oldest to newest).

  • Documentation Planning Meetings – Now is the time to plan for Application Server 10 / GlassFish v3 and we need your input! We've been holding a series of informal planning meetings to which the community has been invited but so far it's been just us doc folks. Are you aware of these meetings? What's been stopping you from attending? What would make it more likely that you'd attend and get involved (different topics, different time, more advance notice, clearer understanding of what's being asked of you)? What would you like to see for docs? How should they be developed and delivered? So many questions! These planning meetings will start up again in January. Details can be found on the meetings page. Please join us!

That's just a sampling of what's been happening in the wonderful world of Application Server docs this past year (in addition to providing complete documentation sets for the Application Server 9.1 / GlassFish v2 and Application Server 9.1 Update 1 / GlassFish v2 UR1 releases!). So to ask the question again: What worked and what didn't? We'd love to hear your answer to that question and to the questions asked in the points above. Please leave a comment here or contact the doc team through the documentation mailing list. We'll be out for the holiday break but will respond to any and all comments when we get back, refreshed and rejuvenated. Thanks in advance, and happy holidays to anyone celebrating them right about now!

Wednesday Nov 21, 2007

GlassFish Developer FAQ and Other FAQ News

I've been working on a few things related to GlassFish FAQs and wanted to bring you up to date.

A revised GlassFish Developer FAQ is now available on the GlassFish Wiki and ready for contributions. It doesn't contain a lot of FAQs at this point, which is where you come in. As with the GlassFish User FAQ, this Developer FAQ is a community effort and a continual work in progress. What's available now is just a start. Please contribute FAQs of your own and make improvements and updates to what's already there.

Content in this new Developer FAQ came from several places – some from the old Developer FAQ on the GlassFish Wiki (that FAQ has been deprecated), and some from the legacy GlassFish FAQ on the Community site. The ultimate goal is to consolidate all such information in the User and Developer FAQs on the wiki. Links on the Community site will then point to these FAQs, and the legacy GlassFish FAQ will essentially go away. This consolidation work isn't quite as simple as it might sound but it's well underway and nearing completion. Please bear with us.

A few other items of note:

  • I've created a GlassFish Wiki FAQ for – you guessed it – frequently asked questions related to the use of the GlassFish Wiki. It's pretty bare-bones at the moment so feel free to add questions of your own.

  • Which reminds me: Have I mentioned that community involvement and contribution are critical to making these FAQs at all useful? =) The FAQs now all have Wishlist sections such as this one in the User FAQ. If you have a question you'd like to see answered but don't have the answer yourself, add it to the list. And all you experts out there – if you know the answer to one or more of these wishlist questions, please provide it!

As always, feedback and comments are most welcome. Let me know what you think about these FAQs – what you like and don't like, what would make them more useful, what keeps you from contributing, those types of things. That would be really good to know.

Friday Nov 02, 2007

GlassFish v3 Documentation Planning

Now is the time to plan for GlassFish v3 documentation and your input is needed! Just as features and enhancements are now being discussed from an engineering perspective, what's on your wishlist for docs?

All members of the GlassFish community are invited to join the documentation team for discussions about GlassFish v3 documentation. The first discussion takes place Monday, November 5th at 8:30 AM Pacific, with other discussions to follow. Dial-in information and other details can be found on the GlassFish v3 Documentation Meetings page on the GlassFish wiki.

If you can't attend the meeting, you can still participate in the discussion through the mailing list. You can subscribe to this list through the GlassFish Community mailing lists page.

Thanks in advance for your input. Community participation is critical as we brainstorm this next generation of GlassFish documentation. We look forward to talking with you.

Wednesday Oct 17, 2007

Glassfish 9.1 Error Message Reference Wiki

Request for community input: Glassfish 9.1 Error Message Wiki

[Read More]

Monday Sep 17, 2007

New Release: GlassFish v2. Read All About It!

Today, Sun announced the immediate availability of GlassFish V2 and its commercially supported counterpart, the Sun JavaTM System Application Server 9.1.

The user documentation provides comprehensive instructions for installing, setting up, and maintaining GlassFish V2 and Sun Java System Application Server 9.1.

In this documentation, you'll find detailed information about how to use new features of this release, such as:

On behalf of the Application Server documentation team, I would like to thank the members of the GlassFish community for their contributions to the documentation.

Friday Sep 14, 2007

GlassFish User FAQ

The GlassFish User FAQ is now available on GlassFish Wiki.

The User FAQ is a relatively new creation and contains frequently asked questions that pertain to the use of GlassFish. As you can see, it's a work in progress, and that's where you come in. Contributions are invited, welcomed, and needed! Go to the URL listed above and see how you can get involved.

Friday Aug 31, 2007

Review Request: GlassFish v2 Documentation

The Application Server documentation team is asking for review feedback on the latest draft of the GlassFish documentation.

If you would like to provide feedback, please use the GlassFish document comment wiki.

To ensure that your feedback is received in time for inclusion in the FCS version of GlassFish v2, please leave your feedback by September 7, 2007.

Thank you.

The GlassFish Documentation Team

Wednesday Jul 18, 2007

Review Request: GUI Online Help and CLI Online Help

The Application Server documentation team is asking for review feedback on the Administration GUI online help and the CLI help in GlassFish Project - b56 Promoted Build - , which was promoted on July 18, 2007.

If you would like to provide feedback, please use the GlassFish Documentation Comments Wiki. To ensure that your feedback is received in time for inclusion in the FCS version of GlassFish v2, please leave your feedback by July 23, 2007.

Thank you.

Friday Jun 01, 2007

New Opportunities for Contributing to GlassFish Documentation

The GlassFish Project - Documentation Home Page has been updated to explain more clearly how to contribute to GlassFish documentation.

The principal change is the creation of the GlassFish Documentation Comments Wiki to simplify the process of providing review comments on GlassFish documentation. For each document in the GlassFish documentation set, a wiki page is provided to which you can add your comments.

If you would like to contribute, just go to the wiki page for the document that you want to review, log in, and edit the page to add your comments.

Monday May 07, 2007

Glassfish Day and JavaOne

Hey folks, Today, Monday May 7th, is Glassfish day before the official start of JavaOne at Moscone Center. Its FREE and there will be presentations on:
  • Glassfish v2
  • Real-World Use: PeerFlix, Wotif.COM, Harvard Multiverse
  • Glassfish Partners: Interface21, TerraCotta, Caucho, Genuitec
  • Glassfish v3 and Open ESB

In addition, there will be many:

  • Demo Stations for hands on encounters
  • Free Goodies: including bumper stickers and t-shirts
  • GlassFish Champion awards
  • Free Lunch with Jonathan Schwartz and Rich Green
  • Reception at the end

Even if you haven't registered, just stop by -- they'll let you in!!!

Also, I'll be at JavaOne Tues and Wed. at the SDK booth. Come by and say hello!

SDK Update 3 Preview 2 is Live

The new SDK Update 3 Preview just launched. It includes many new and cool components:

Download the SDK at:

Lots of cool new stuff!!!


The scoop on GlassFish documentation and more!


« July 2016