Trecho d'um artigo da eWeek:

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 don't 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."

Share knowledge... single most crucial determining factor for prosperity...

Mais um grande passo d'uma grande comunidade. Prá conhecer o serviço clique aqui.