David is working on references.

Jano, I miss text which should be shown in description for each type. 

Also, do you insist on icons? At the moment there are not any (it is
plain listbox) and resolved items automatically disappear. If you want
icons there let me know and attached them to this issue. I would
prefer to leave it as it is, but it is up to you.

The rest is implemented in:
src/org/netbeans/modules/java/project/BrokenReferencesCustomizer.form;
new revision: 1.2; previous revision: 1.1
src/org/netbeans/modules/java/project/BrokenReferencesCustomizer.java;
new revision: 1.3; previous revision: 1.2
src/org/netbeans/modules/java/project/BrokenReferencesModel.java;
new revision: 1.5; previous revision: 1.4
src/org/netbeans/modules/java/project/Bundle.properties;
new revision: 1.9; previous revision: 1.8
src/org/netbeans/spi/java/project/support/ui/BrokenReferencesSupport
new revision: 1.2; previous revision: 1.1

Created attachment 15811 [details]
Broken project.

John, could you please look at the wording. The broken project is attached.

wording suggested by Chris: It should say "Use the Resolve Reference
Problems action on the project's contextual menu to fix the reference
problems."

Thanks for the wording correction. I updated the spec.

Sorry for taking so long. Here's my recommendation for the text:

"One or more project resources could not be found. Use project
contextual action Resolve Reference Problems to fix the problems." 
should be:
"One or more project resources could not be found. Right-click the
project in the Projects window and choose Resolve Reference Problems
to find the missing resources."

"Show this message again" should be "Do not show this message again"

"The project depends on other project which was not found. The foreign
project reference is "MySubproject1". Correction: press Resolve button
and find that project."
should be
"Problem: The project classpath includes a reference to the project
called "MySubproject1", but this project was not found. 
Solution: Click Resolve and locate the missing project."

"The project uses file or folder which was not found. The reference
name is "something.jar". Correction: press Resolve button and find
that file/folder."
should be
"Problem: The project uses the file/folder called "something.jar", but
this file/folder was not found.
Solution: Click Resolve and locate the missing file/folder."

"The project is setup to use Java Library with name "my-lib", but this
library was not found. Correction: press Resolve button and create new
library with name "my-lib"."
should be
"Problem: The project uses a Java Library called "my-lib", but this
library was not found. 
Solution: Click Resolve and create a new library called "my-lib"."

Question - what is a Java Library? Is this the type of project? How do
you know that they need to create a new one instead of finding an
existing one?

"The project is setup to use Java Platform with name "jdk15-test", but
this platform was not found. Correction: press Resolve button and
create new platform with name "jdk15-test"."
should be
"Problem: The project uses the Java Platform called "jdk15-test", but
this platform was not found. 
Solution: Click Resolve and create new platform called "jdk15-test".

Thanx.

Re. "What is it Java Library": Java Library is logical concept which
allows to define a library which consists of one or more jar files,
associate sources and javadoc to jars, etc. See Tools->Library Manager.

Re. "How do you know that they need to create a new one instead of
finding an existing one?" - I know it. :-) The shared part of project
metadata has reference name of the library and its corresponding
library is simply not found during the project opening.

Cool, so let's use this for the problem description:

"Problem: The project uses a class library called "my-lib", but this
class library was not found. 
Solution: Click Resolve to open the Library Manager and create a new
class library called "my-lib"."

If everybody agree I will change the text tomorrow.

Looks good to me. Thanks John for the wording.

Fixed in:
src/org/netbeans/modules/java/project/BrokenReferencesAlertPanel.form;
new revision: 1.4; previous revision: 1.3
src/org/netbeans/modules/java/project/BrokenReferencesAlertPanel.java;
new revision: 1.4; previous revision: 1.3
src/org/netbeans/modules/java/project/Bundle.properties;
new revision: 1.17; previous revision: 1.16

This issue was solved long time ago. Because nobody has reopened it neither
added comments, we are verifying/closing it now. 
If you are still able to reproduce the problem, please reopen. Thanks in advance.