[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

  • From: Geertjan Wielenga < >
  • To:
  • Subject: [nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)
  • Date: Mon, 04 Mar 2013 11:02:48 +0100


Plus, my blog entries are normally 70% right, at best. I.e., you'll often find people ranting in the comments about how wrong the things are that I'm writing. I'd hate to cast my blog entries in stone by listing them on the wiki how-tos. Instead, what I do is -- after some time has passed and the rants have calmed down -- integrate them into tutorials that I'm working on.

But the point for me is still the same -- use Google. You'll find blogs, tutorials, wikis, mail threads. Works well.

Gj

On 03/04/2013 10:55 AM, Geertjan Wielenga wrote:


Many of them are already, e.g., the Print section here comes from my blog: http://wiki.netbeans.org/NetBeansDeveloperFAQ

I'd recommend the very first place to look is Google -- you'll find my blog entries, as well as Wikis, as well as other articles, and mailing lists.

Gj

On 03/04/2013 09:56 AM, Jean-Marc Borer wrote:
Hi Geertjan,

Your blogs contains a tremendous amount of useful information.
Sometimes however searching it can be difficult: the search results
are not very accurate when you roughly remember having read something
about a topic and want to find the article again.

Wouldn't it be a good idea to link them or even better copy them to
the netbeans wiki how-to? There would be then a central place to look
for information. Sometimes google even keeps links to articles before
Oracle-Sun acquisition and which are broken. Not a very happy user
experience.

Cheers,

Jean-Marc

On Fri, Mar 1, 2013 at 4:03 PM, Geertjan Wielenga
< >
 wrote:
On 03/01/2013 04:30 PM, Jean-Marc Borer wrote:
Hi Geertjan,

I agree that a lot of work has been done for a better support of Maven in
NB.

However if you follow this "huge" thread now, you can spot several
areas of improvement concerning documentation.

It starts with the nbm Maven plugin. I am working now for several
years with Maven and still have sometimes problems to understand the
plugins documentation. Let's take an example. There are a lot of
options possible in the configuration part but you have to guess how
to use it.

No, you need to do research. Whenever I have a question, I use Google and I
also find the answer I'm looking for, sometimes take a bit longer. But
guessing has nerver been needed.

Would it help if I were to add an item on the page below "Topics that need
to be documented"?

http://wiki.netbeans.org/NetBeansDeveloperFAQ

But, I'm a bit sceptical because this that you write is true for most
people: "Unfortunately I can't remember right now all the

documentation I am missing. Most of the time I can think about it when I run
into problems I can't find  a solution in the books."

Also, as soon as you have an answer to something, i.e., you have learned
something new, via the mailing list or otherwise, you should be going to the
page above and registering your new knowledge there as a new how to.

Gj


On Fri, Mar 1, 2013 at 2:59 PM, Geertjan Wielenga
< >
 wrote:
On 03/01/2013 03:53 PM, Jean-Marc Borer wrote:
I also agree, the learning curve is steep and most users would turn
away from the platfomrm when they encounter difficulties like I had.
Maven with NB RCP is still kind of second zone citizen. There so much
wizards and UI with ant based project that simplify your life.

Which wizards and UI for Ant projects is not there for Maven projects?
With ant projects you have in properties the version module panel
where you can define what you need and also the libraries panel with
the magic "resolve" button which would have helped me and Thomas to
save a LOT of time. There should be a nice "resolve" dependency wizard
for Maven.

Now concerning documentation: since there are not such wizards and gui
comps with Maven projects, it should be documented how to achieve the
same goals. Here is a list of what I can think about:

* how define an implementation version and how the Maven version will
be used (spec, major, impl?)
* how Maven dependencies will processed by the plugin

Other topics not related to Maven but could have their doc improved
* All the dependency classloading stuff. This doc

http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/classpath.html
is helpfull but too techy. It doesn't provide a nice learning path.
* How to define keyboard shortcuts with annotations
* there almost no documentation about clusters and Maven. How to use
them, where to find them (again the UI wizard provides that) and how
to create your own ones.

As you might know I have all the books available on Netbeans (yours,
Heiko's and Petri's ones). What I am missing is more ore less howto's.
There are already some good ones on the wiki, but there is still room
for more. Unfortunately I can't remember right now all the
documentation I am missing. Most of the time I can think about it when
I run into problems I can't find  a solution in the books. Maybe we
should create a page on the wiki where everyone could suggest howto
themes (maybe it already exists, sorry I don't now it yet then).

This is my first feedback. Sorry for my english errors, but I am a bit
short of time for now.

Cheers,

Jean-Marc





[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

(continued)

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Wade Chandler 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/04/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/04/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/04/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/04/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Wade Chandler 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Wade Chandler 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Geertjan Wielenga 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Jean-Marc Borer 03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

03/01/2013

[nbdev] Re: Maven Netbeans builds and dependencies issues (especially transitive ones)

Milos Kleint 03/22/2013

Project Features

About this Project

www was started in November 2009, is owned by jpirek, and has 21 members.
By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20131025.e7cbc9d). © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
 
 
Close
loading
Please Confirm
Close