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).