This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 133842 - Not informative NetBeans description is used in Java Tools Bundle.
Summary: Not informative NetBeans description is used in Java Tools Bundle.
Status: RESOLVED FIXED
Alias: None
Product: installer
Classification: Unclassified
Component: Code (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: dlipin
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-04-24 14:22 UTC by Daria Titova
Modified: 2008-07-22 19:04 UTC (History)
3 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
NetBeans description on Customize panel (40.65 KB, text/plain)
2008-04-24 14:24 UTC, Daria Titova
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Daria Titova 2008-04-24 14:22:37 UTC
On Customize Installation panel NetBeans description should be informative, not just a slogan.
See attachment.
Java EE 5 Tools Bundle Update 5 - 2008-04-23
Comment 1 Daria Titova 2008-04-24 14:24:17 UTC
Created attachment 60654 [details]
NetBeans description on Customize panel
Comment 2 dlipin 2008-04-24 14:34:53 UTC
what is the informative description then?
Comment 3 dlipin 2008-04-24 14:40:10 UTC
->P3 According to bug priority guidelines 
Comment 4 Yulia Novozhilova 2008-04-24 17:37:08 UTC
Please, try the following:

1) move /usr/local/MySQLCOM into /Library/StartupItems/
2) run sh -x /Library/StartupItems/MySQLCOM/MySQLCOM start

Comment 5 Yulia Novozhilova 2008-04-24 17:45:52 UTC
ups, previous comment is mistakenly added. it is about #133847. 
Comment 6 Daria Titova 2008-04-25 14:24:47 UTC
The wording is definitely not descriptive from my point of view. Was it confirmed with marketing or program management?
If so, then probably it is fine.

This is not QE responsibility to provide marketing-correct and wording-correct descriptions. But in case you are
interested in my opinion - I would go to official Netbeans site for description.

For example, if you open netbeans.org, then click on the NetBeans 6.1 logo on top left - you will get to page with the
following as the first sentence:

The NetBeans IDE is a modular, standards-based, integrated development environment (IDE) written in the Java programming
language.

What about this sentence? 
Comment 7 _ gsporar 2008-06-06 15:44:14 UTC
Hmmm...  agreed.  "The only IDE you need" is certainly not appropriate in this context.

I'm happy to offer suggestions, but first I would like to know:

1. What descriptions are used for some of the other entries?  For example, for "Portal Pack 2.0" and "Open ESB v2"

2. Which exact download of NetBeans IDE is provided in this installer?  I am assuming the Web & Java EE download - is
that correct?

In an email, dlipin made the comment that the description should ideally "not contain any specific features like Ruby,
C++, GUI Builder etc."  But I am not certain that I agree with that - it seems like it might be helpful to the user if
the description mentions specific features that are important for someone who is installing the Java EE 5 Tools Bundle.

HTH - Gregg
Comment 8 dlipin 2008-06-06 16:01:05 UTC
Hi Gregg,

> 1. What descriptions are used for some of the other entries?  For example, for "Portal Pack 2.0" and "Open ESB v2"
Open ESB:
Open ESB implements an Enterprise Service Bus (ESB) runtime using Java Business Integration (JBI) as the foundation. 
Open ESB is an open standard, open-source product that offers a platform to build integration solutions based on 
service-oriented architecture (SOA).
Portal Pack:
This module supports full life-cycle of portlet application development inside NetBeans. Using this tool portlet 
developers can develop, package, deploy and test portlet inside their NetBeans IDE. By automatic code and Deployment 
Descriptor generation, this tool helps developers to develop portlets quickly. It provides a tight integration with 
portal servers to support deployment and undeployment of portlets on both local and remote server.
AppServer:
The Sun Java System Application Server 9.1 is a Java EE 5 platform-compatible server for the development and deployment 
of Java EE applications and Java technology-based web services in large-scale production environments.

> 2. Which exact download of NetBeans IDE is provided in this installer?  I am assuming the Web & Java EE download - is
that correct?
Web & Java EE + SOA

> In an email, dlipin made the comment that the description should ideally "not contain any specific features like Ruby,
C++, GUI Builder etc."  
> But I am not certain that I agree with that - it seems like it might be helpful to the user if
the description mentions specific features that are important for someone who is installing the Java EE 5 Tools Bundle.

If it is possible I`d like to keep NetBeans description general so that it can be used in any similar contest.
In this bundle NetBeans stands for "Base + Java SE + Web & Java EE + SOA"... but there is a possibility that we reuse 
this group name and description somewhere else.. Surely, it is only technical implementation issue. We can create 
another group and use another description for it. But in that case we, again, would have to solve the same problem - 
find out the description for that components group. That is why I want to have it in a general way.
Anyway, I can trust you, Gregg, with naming. If you think that mentioning the specific features is important then I 
can`t but agree with you. You are the naming expert, not me :)

Dmitry
Comment 9 _ gsporar 2008-06-06 16:29:35 UTC
Hmmm....

I see your point about re-use of the sentence.  

How about this: "The NetBeans IDE is a modular, standards-based, integrated development environment (IDE) that provides
full support for the technologies included in this tools bundle."

It is sort of a compromise - it does not mention specific technologies, but it makes it clear to the user that the IDE
is not just there taking up space.  In other words, it provides the user with some information on *why* they would want
to install the IDE.

But the wording is generic, so it could be re-used in other tools bundles.

HTH - Gregg
Comment 10 _ tboudreau 2008-06-09 06:50:06 UTC
Who is the audience?  If we want to make sense to non-programmers, the language will be different than for programmers.

Non-programmer-friendly:
"The NetBeans IDE is a tool for writing, debugging and running computer programs - in many languages.  A word-processor for programmers...and an 
assistant and publisher, all rolled into one."

Slightly longer version:
"The NetBeans IDE is a tool for writing, debugging and running computer programs - in many languages.  A word-processor for programmers - that 
/understands/ what you're trying to write...and an assistant and publisher, all rolled into one."

Variant (don't bother explaining "IDE" or * it):
"If you're writing a book, you use a word processor.  If you're programming, you use an IDE - a word processor for programmers - which is what NetBeans 
is.  It understands a lot of different programming languages, and it's written in Java - so you can use it on any kind of computer."


All I can think of for now.  The main thing is to make it clear to true neophytes without sounding condescending to people who know what an IDE is, etc.
Comment 11 dlipin 2008-06-23 19:26:54 UTC
Tim,

I am pretty much that we target experienced programmers (not beginners) audience, at least in this Java EE Tools Bundle.
If we speak about NetBeans/JDK bundle then we __can__ speak about beginner programmers...

Dmitry
Comment 12 dlipin 2008-07-22 19:04:08 UTC
fixed.
http://hg.netbeans.org/main/rev/6773e3d241c0
Comment 13 dlipin 2008-07-22 19:04:35 UTC
f.