If you've ever programmed in PHP, Ruby, Perl, Groovy, and probably others, then you know how nice it is to have a central, official space for reference documentation and inline community feedback.

This is something that has sorely been missing from the JEE community, and something that has caused many disparate websites to attempt putting forward a weak effort in providing useful documentation -- you leave the community part aside to think that this is a good thing for any open-source technology.

A successful open-source community documentation initiative has:

  • Comprehensive documentation provided on a central, official website (
  • Inline comments and user feedback.
  • The most common paths on the website are the most visible, intuitive paths.
  • Fluent navigation and document hierarchies. (The URL matches the Breadcrumbs matches the content. If users get lost, users give up.)
  • Accurate and relevant official information, well vetted information.

I'm sure there is more, but that's what I have at the top of my head.

Making progress happen:

In kick-starting my (hopefully long) tenure with Red Hat, I'm focusing on improving community documentation for the Seam Framework, and for Java EE as a whole. I've started by updated the Seam Framework website to more clearly display the links to Seam and Weld JIRAs; you previously had to do a little digging.

All of my efforts can be tracked here:

Please, I ask if you find any outstanding problems, or points of pain with the Seam or Weld documentation, to add it to this Jira. If you can't, then comment here and I'll see that it's addressed. needs work, and I do think that the community really belongs on, in order to fully get credit for their hard work and great achievements. also provides much of the functionality that I'm looking for in a community management tool, but we'll see what everyone wants ;)

Happy communities make happy software!

05. Mar 2010, 08:55 CET | Link

Good to see someone will work on documentation! PS: Your name is not listed on the Bloggers sidebar... ;)

05. Mar 2010, 11:15 CET | Link
Grzegorz Grzybek

I'd like to add one more thing - not directly related to documentation but rather to source code:

  • one (maybe mirrored) reliable source of maven artifacts (jar, source, pom)

It's not a case with some bassic JEE jars (servlet-api, jsp, el, ...)

regards Grzegorz Grzybek

05. Mar 2010, 13:30 CET | Link
This is a good initiative and must for one global reference!

07. Mar 2010, 23:28 CET | Link
Grzegorz Grzybek wrote on Mar 05, 2010 05:15:
I'd like to add one more thing - not directly related to documentation but rather to source code:
  • one (maybe mirrored) reliable source of maven artifacts (jar, source, pom)
It's not a case with some bassic JEE jars (servlet-api, jsp, el, ...) regards Grzegorz Grzybek

Grzegorz, that is definitely an initiative that Red Hat is pursuing aggressively. We recognize what a barrier this places on adoption of Java EE--exactly the type of barrier that we seek to remove.

You should note that progress has been made recently with Sonatype's effort to merge the repository artifacts into central.

08. Mar 2010, 13:56 CET | Link
Grzegorz Grzybek | gr.grzybek(AT)

I appreciate what JBoss and Sonatype do to make JavaEE more elegant and organized.

I've also commented on this subject at

Generally I'm frustrated that there is no official javax.servlet:servlet-api:3.0 artifact, I've found it at org.glassfish:javax.servlet:3.0. Also there are no sources for JavaEE 6 APIs and classes are packaged in an all-in-one fashion.

I wish Sun (Oracle) created better repository, both for maven artifacts and for sources (there are more CVS tags for e.g. JAX-WS than pages in EJB specification...)

So - I hope that with JBoss and Sonatype's effort we'll live to see clear and well organized repository of JavaEE.


30. Aug 2014, 03:57 CET | Link

Best friend successive good years, Gucci Shoes Factory, winter spent in Sanya, Monster Beats Outlet, so winter home, seems to be nowhere in sight, North Jackets Outlet, both a little rusty, Nike Air Max Shoes, but also very cordial, Burberry Outlet Online, forward to tonight, feather-like snow, MCM Bags Outlet, drifts underground, Coach Black Friday, looking at that the floc, Louis Vuitton Outlet, fly like snow Ling, Michael Kors Outlet Online, eloquent, Polo Outlet Online, flying in the sky, Cheap Canada Goose, limp walk downs, strange things, Marc Jacobs Outlet Online, I float thinking lianpian, North Outlet Online, poetic heart wenqing, not help surging surging, Coach Factory Outlet, so I borrowed the winter, Ralph Lauren UK, snows research ink, Longchamp Sacs Sortie, into the mind of inactivity, Michael Kors Outlet, the white snow everywhere, Monster Beats By Dre, wrapped in some different, Ralph Lauren Outlet, kind of scenery, Oakley Sunglaases Outlet, wherever the wind in the faces, of the people, Michael Kors Bags Outlet, who are very Huddled, could not help.

21. Nov 2014, 03:10 CET | Link
02. Dec 2014, 05:38 CET | Link

ACE MAXS Obat Tumor Payudara Jinak Dan Obat Tumor Payudara Alami Yang 100% Herbal, Ampuh, Manjur Serta Tanpa Efe Samping.