Sorry if this is already in JIRA, I looked and could not find. I know there is a lot of
activity getting the functionality in, but the documentation is really important in terms
of usability. Easily finding the documentation is as important as having it.
Documentation has grown since JBDS 1, but I still find nothing under the Eclipse help.
My Help Contents:
Workbench User Guide
| Java development user guide
| Plug-in Development Environment Guide
| BIRT Report Developer Guide
| C/C++ Development User Guide
| Dali Java Persistence Tools User Guide
| Hibernate Developer Guide
| Javascript Development Toolkit User Guide
| JavaServer Faces Tooling User Guide
| Monitoring and profiling applications
| Mylyn
| RSE User Guide
| Testing applications
| Usage Data Collector
| Web Tools Platform User Guide
| Working with the Agent Controller
Second point, the documentation is mostly fragmented based on the individual plugins (that
is how the JIRA items are categorized as well). The only overall documentation seems to
be the Getting Started Guide. It would be nice to one unified document at a deeper level
than the getting started guide.
Third point, If I have downloaded JBDS or installed JBT, or if I am sitting down at a
machine that has it and open eclipse, I would tend to go to the elipse help to find docs
or tutorials on how to use the features. With eclipse, there is always potential
confusion between multiple plugins that seem to address similar tasks. For example, what
do I use for JPA? Dali, Hibernate, something built into Seam? It would be nice if the
use cases applicable to JBT/JBDS were clearly described along with corresponding tool
usage.
Working through a nontrivial example using all of the tools would also be good, for
example the Seam booking example from scratch (if this is already there, sorry).
View the original post :
http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4196966#...
Reply to the post :
http://www.jboss.com/index.html?module=bb&op=posting&mode=reply&a...