Role in IT decision-making process:Align Business & IT GoalsCreate IT StrategyDetermine IT NeedsManage Vendor RelationshipsEvaluate/Specify Brands or VendorsOther RoleAuthorize PurchasesNot Involved

Work Phone:

Company:

Company Size:

Industry:

Street Address

City:

Zip/postal code

State/Province:

Country:

Occasionally, we send subscribers special offers from select partners. Would you like to receive these special partner offers via e-mail?YesNo

Your registration with Eweek will include the following free email newsletter(s):News & Views

By submitting your wireless number, you agree that eWEEK, its related properties, and vendor partners providing content you view may contact you using contact center technology. Your consent is not required to view content or use site features.

By clicking on the "Register" button below, I agree that I have carefully read the Terms of Service and the Privacy Policy and I agree to be legally bound by all such terms.

Project Brings Javadoc to Dynamic Database

JDocs, a new online community site from Javalobby, takes Java documentation in static HTML format and delivers it to developers via a dynamic database, where they can contribute notes and share information.

Javalobby this week released a new online Java documentation community site that enables developers to not only access documentation for popular Java tools and libraries, but also to cross-link, search and provide user-contributed notes.

Rick Ross, president of Cary, N.C.-based Javalobby Inc., which is a grass-roots organization representing hundreds of thousands of Java developers, called JDocs "one of the biggest things we have done" since creating the organization.

Ross said JDocs serves an important purpose by taking typical Java documentation—known as javadoc, which exists in static HTML format—and delivering it to developers via a dynamic database. Javadoc is a tool for generating API documentation in HTML format from "doc" comments in source code. It is the de facto standard for Java documentation, Ross said.

"Because we have a dynamic, database-driven application, we have the ability to allow developers to put in user-contributed notes" along with the documentation.

"The basic idea behind JDocs is that the knowledge in the javadoc API documentation can be materially enhanced by user-contributed notes," Ross said. "The overall value of the API knowledge grows as JDocs users share their questions, answers, tips, links, example code and other relevant information with each other. The JDocs service provides a home for a community-based effort to gather and share this Java API knowledge."

Ross said that in relation to JDocs, the term API—which typically means application programming interface—refers to a complete package of classes and interfaces such as Java 2 Standard Edition (J2SE) and the open-source Spring and Hibernate environments.

One of the hassles of Java programming is the tedium of finding the right documentation, Ross said. "You have to know where it is, or you have to have it locally on your computer. … Every developer needs documentation, because you dont intuitively know everything and you have to look it up."

And to make things easier, "you need to have the documentation searchable and available in one place," Ross said.

Regarding the value of the JDocs project, Ross said, "In my opinion, sharing knowledge about real programming will be the single most crucial determining factor for prosperity and long-term success for virtually every developer in the global Java community."

Ross said the JDocs project has generated a groundswell of support in the community, prompting hundreds of e-mails since the site went live earlier this week.

"The thing that is most encouraging to me, even with all of the positive feedback from the community, is the quality and quantity of the user-contributed notes that are already starting to flow in," Ross said. "Because it is in those comments that well find the sharing of knowledge which I believe is so vital."

In addition, Ross said Javalobby has some "super slick" features, already operative but not yet public, that allow any user to subscribe to RSS feeds from virtually any level of the hierarchy, "making it drop-dead simple, for example, to monitor the feedback about the JDBC [Java Database Connectivity] package or any of its classes."

Meanwhile, Ross said a Java developer has already written a JDocs plug-in to the Eclipse open-source application development platform.

Advertiser Disclosure:
Some of the products that appear on this site are from companies from which QuinStreet receives compensation. This compensation may impact how and where products appear on this site including, for example, the order in which they appear. QuinStreet does not include all companies or all types of products available in the marketplace.