meaning of icons in project and packages panes

It seems strange to me that nowhere is there a description of the
decorations on icons for the objects in the project and package view panes.
I have figured out what most of them mean but it seems like a big oversite
for people who are new to the product. Does anyone have a listing that they
have compiled?

The best information is the description of the "Sort by Type" heading under
Project Views in the help. This describes the main class type icons but then
does not go on the describe the various decorated versions of these icons.

One of the reasons I use Intellij instead of Eclipse is because I want to
spend my time solving my design and coding problems and not how to use the
IDE effectively.

I just received "Intellij IDEA in Action", which I like. It along with the
IDEA help provides no additional coverage of this topic.

William Crispin


2 comments

Agree. I would re-state the issue more generally. IMHO, the IDEA Help could have been better, to say the least. For the most part the Help just redundantly describes the obvious (thanks to IDEA's self-explanatory design, to a great extend!) but fails to deliver some essential explanations when they are really needed. Sometimes, in addition to simply repeating in more words what the button caption already says, the help text could provide the context and explanation of, for example, when, why, and how the feature could be used. I still don't know - and, by now, don't want to know - what the heck I need the Commander tab for! (And I can't even get rid of it! :) ) Sometimes the meaning is ambiguos, but the help file does not tell me any more than is already obvious from just looking at the dialog box.

That said, I don't find myself needing to use help too often. Thanks for this, JetBrains! No sarcasm here. However, I remember having to "fill in the blanks" here and there when trying to set up Weblogic/J2EE application for the first time. Generally, those tiny little details that are often omitted from the help (or implied but not spelled out) could have saved us all some precious time setting things up. My $.02...

Thanks.

0

Hello,

Yes, we know that our help is not perfect. And yes, we are rewritting it
right now. I hope that most topics will be updated in release 6.0. In particular,
doc team is going to restructure and improve J2EE part, and general issues
related to inspections/static code analysis and project settings and managent.
We have already updated Refactoring part (you can find in Demetra EAP builds).
Also we have rewritten Subversion Integration chapter in release 5.1. Probably,
this can give you an impression how the help is going to be updated.
Also, if you have any suggestions/comments related to help, we are ready
to discuss it. Please, post them into jetbrains.intellij.documentation news
group.


Best regards,
Alexandra Rusina,
Technical Documentation Team Lead
-


JetBrains, Inc
http://www.intellij.com
"Develop with pleasure!"

Agree. I would re-state the issue more generally. IMHO, the IDEA Help
could have been better, to say the least. For the most part the Help
just redundantly describes the obvious (thanks to IDEA's
self-explanatory design, to a great extend!) but fails to deliver some
essential explanations when they are really needed. Sometimes, in
addition to simply repeating in more words what the button caption
already says, the help text could provide the context and explanation
of, for example, when, why, and how the feature could be used. I still
don't know - and, by now, don't want to know - what the heck I need
the Commander tab for! (And I can't even get rid of it! :) )
Sometimes the meaning is ambiguos, but the help file does not tell me
any more than is already obvious from just looking at the dialog box.

That said, I don't find myself needing to use help too often. Thanks
for this, JetBrains! No sarcasm here. However, I remember having to
"fill in the blanks" here and there when trying to set up
Weblogic/J2EE application for the first time. Generally, those tiny
little details that are often omitted from the help (or implied but
not spelled out) could have saved us all some precious time setting
things up. My $.02...

Thanks.



0

Please sign in to leave a comment.