Well, I am quite annoyed with the way, how JetBrains conducts the documentation and tutorial business with the last IntelliJ releases. Currently, I am exploring the new Hibernate, JPA, and Spring features and quite often I am lost. The few pages, which are available in the "help system" look more or less like placeholders and aren't by any means suitable for new users of either Hibernate, Spring etc. or IntelliJ. If I compare this to other products such as MyEclipse (which are even cheaper than IJ), IntelliJ looks like one of these poorly documented open source projects.
We have to train new team members to IntelliJ and try to figure out the new support for the aforementioned frameworks. However, if me, as a long time IJ user, cannot figure many things out by myself, how should the other newbies?
For example: I want to use Hibernate with annotations. Do I have to setup a Hibernate facet, a JPA facet or both?
If a create an entity with JPA annotation, can I generate an appropriate database table - I couldn't figure out. I want to create first my domain model, do the mapping with annotations, and create the DB table form it. Looks like this is not possible. Or is it?
Really, please, provide more and better material to get unexperienced users learn IntelliJ and its new features. If the documentation business keeps in its current stage, I am afraid that the move to MyEclipse in inevitable.
We use IntelliJ since version 2.5 and have made every upgrade step since then. However, I feel that the discrepancy between the IDE's complexity and its documentation was never so big as with IntelliJ 7.0.
It's not the fist time, I complain about JetBrain's failure to provide appropriate IDE documentation and tutorials. So far, I haven't seen any improvements, it seems they value this topic less with each release. What a pitty.