Re: Apache NetBeans Apress Book

2018-07-18 Thread Josh Juneau
Hi everyone,

I do not personally have much experience with open source (free) books.  
However, for the Jython book we were able to use an online copy of it on the 
Jython wiki.  Not sure if we could do something similar here.  

John, if you are interested in becoming the lead then that is great.  I can 
work with you to get in touch with the editor to get the project started.  

We should decide as a community first on how we want this book to be 
published...vis Apress or other means?

Personally I have worked with Apress many times now and they are very 
accommodating. However, I am open to looking at a free alternative if the group 
would rather go that route.

Thanks 


Josh Juneau
http://jj-blogger.blogspot.com
https://www.apress.com/index.php/author/author/view/id/1866


> On Jul 18, 2018, at 1:24 PM, Delfi Ramirez  wrote:
> 
> Hi all, Hi Pete:
> 
> I guess, there may be a previous formal written contract between the writers 
> ( our community) and the publishing company, (APress or whoever).
> 
> If any of the writers ( code is text, text are strings, remember) has a 
> formal contract with his/her software company he/she should ask for the 
> permission to act on her/his personal behalf.
> 
> Money you pay for a physical book covers the expenses of print, logistics ( 
> storage , delivering)  and marketing. It also covers the licenses and , if 
> accorded, the rights of the publisher.
> 
> Et cetera.
> 
> Hope it helps.
> 
> Cheers
> 
> 
> 
> Delfi Ramirez
> 
> Segonquart Studio
> 
> https://segonquart.net
> 
> From: Peter Steele
> Sent: 18 July 2018 20:17
> To: dev@netbeans.incubator.apache.org
> Subject: Re: Apache NetBeans Apress Book
> 
> I had a look at Apress and there are quite a few books on netbeans (one
> already that uses Netbeans 9 for its demos!). They all cost money
> (unsurprisingly), I was wondering how that would fit in to a community
> written book?
> 
> I don't have any expertise to add myself (I'm kind of waiting till things
> stabilise to a standard development life cycle before investing some time
> in to adding enhancements) but was interested in how it would work.
> 
> Is it better to actually just write a free book? Or do Apress bring a lot
> to the venture?
> 
>> On Wed, 18 Jul 2018 17:22 Mario Schroeder,  wrote:
>> 
>> Hi Miloš,
>> 
>> that what you describe is what I also thought about. I got an book about NB
>> too, but the samples there don't use the annotations and some classes are
>> even deprecated. So an update to the latest version of the platform would
>> be great. I could be your copilot if you need help in reviews and
>> correction.
>> 
>> Regards,
>> Mario
>> 
>> Miloš Šilhánek  schrieb am Mi., 18. Juli 2018,
>> 17:54:
>> 
>>> Hi,
>>> I was been interested some years ago in NetBeans Platform. I organized
>>> translation from English to Czech and cowrote a NetBeans Platform
>>> Cookbook
>>> which were not realized - it is on NB wiki pages.
>>> 
>>> So I leaved it - because of time and the need of application based on NB
>>> Platform disappears in my work.
>>> Now is all by browser. :-(. But NBP is suitable for many application as
>>> the
>>> showcase shows.
>>> 
>>> 
>>> 
>>> 
>>> The book was made for NB 6.9.1 and tested for 7.1. Many features were
>>> moved
>>> to annotations in this time. We both had no time to upgrade it.
>>> 
>>> 
>>> 
>>> 
>>> My English is poor so I could upgrade these examples or test new
>> examples.
>>> 
>>> Milos
>>> 
>>> 
>>> 
>>> 
>>> 
>>> -- Původní e-mail --
>>> Od: Delfi Ramirez 
>>> Komu: dev@netbeans.incubator.apache.org <
>> dev@netbeans.incubator.apache.org
 
>>> Datum: 16. 7. 2018 13:56:18
>>> Předmět: RE: Apache NetBeans Apress Book
>>> "Hi All:
>>> 
>>> Agreed there is the need of a chapter-by-chapter community written book.
>>> 
>>> Count me in. Even if there is the need for the book, once written, of a
>>> single translator for the whole community content.
>>> 
>>> Even everyone of us has English as a mother tongue or second tongue, we
>>> may
>>> able to reach and target new markets and new loyal fellows in this world
>>> wide world we live in
>>> 
>>> Cheers
>>> 
>>> 
>>> Delfi Ramirez
>>> 
>>> Segonquart Studio
>>> 
>>> https://segonquart.net
>>> 
>>> From: Oliver Rettig
>>> Sent: 16 July 2018 13:47
>>> To: dev@netbeans.incubator.apache.org
>>> Subject: Re: Apache NetBeans Apress Book
>>> 
>>> Hi all,
>>> 
>>> I like the idea of a community-written book very much. This can encourage
>>> people to join
>>> our great community and it show that netbeans is now a apache project ...
>>> For me the
>>> community is one of the most important facts to work with netbeans and
>>> rarely with eclipse.
>>> 
>>> I have some experience with writing a book for Tomcat 5:
>>> 
>>> https://www.rheinwerk-verlag.de/tomcat-5_700/
>>> 
>>> and the most important thing I have learned from this book project is:
>>> better not to write
>>> such books alone.
>>> 
>>> It would be a pleasure for me to write a chapter for 

RE: Apache NetBeans Apress Book

2018-07-18 Thread Delfi Ramirez
Hi all, Hi Pete:

I guess, there may be a previous formal written contract between the writers ( 
our community) and the publishing company, (APress or whoever).

If any of the writers ( code is text, text are strings, remember) has a formal 
contract with his/her software company he/she should ask for the permission to 
act on her/his personal behalf.

Money you pay for a physical book covers the expenses of print, logistics ( 
storage , delivering)  and marketing. It also covers the licenses and , if 
accorded, the rights of the publisher.

Et cetera.

Hope it helps.

Cheers



Delfi Ramirez

Segonquart Studio

https://segonquart.net

From: Peter Steele
Sent: 18 July 2018 20:17
To: dev@netbeans.incubator.apache.org
Subject: Re: Apache NetBeans Apress Book

I had a look at Apress and there are quite a few books on netbeans (one
already that uses Netbeans 9 for its demos!). They all cost money
(unsurprisingly), I was wondering how that would fit in to a community
written book?

I don't have any expertise to add myself (I'm kind of waiting till things
stabilise to a standard development life cycle before investing some time
in to adding enhancements) but was interested in how it would work.

Is it better to actually just write a free book? Or do Apress bring a lot
to the venture?

On Wed, 18 Jul 2018 17:22 Mario Schroeder,  wrote:

> Hi Miloš,
>
> that what you describe is what I also thought about. I got an book about NB
> too, but the samples there don't use the annotations and some classes are
> even deprecated. So an update to the latest version of the platform would
> be great. I could be your copilot if you need help in reviews and
> correction.
>
> Regards,
> Mario
>
> Miloš Šilhánek  schrieb am Mi., 18. Juli 2018,
> 17:54:
>
> > Hi,
> > I was been interested some years ago in NetBeans Platform. I organized
> > translation from English to Czech and cowrote a NetBeans Platform
> > Cookbook
> > which were not realized - it is on NB wiki pages.
> >
> > So I leaved it - because of time and the need of application based on NB
> > Platform disappears in my work.
> > Now is all by browser. :-(. But NBP is suitable for many application as
> > the
> > showcase shows.
> >
> >
> >
> >
> > The book was made for NB 6.9.1 and tested for 7.1. Many features were
> > moved
> > to annotations in this time. We both had no time to upgrade it.
> >
> >
> >
> >
> > My English is poor so I could upgrade these examples or test new
> examples.
> >
> > Milos
> >
> >
> >
> >
> >
> > -- Původní e-mail --
> > Od: Delfi Ramirez 
> > Komu: dev@netbeans.incubator.apache.org <
> dev@netbeans.incubator.apache.org
> > >
> > Datum: 16. 7. 2018 13:56:18
> > Předmět: RE: Apache NetBeans Apress Book
> > "Hi All:
> >
> > Agreed there is the need of a chapter-by-chapter community written book.
> >
> > Count me in. Even if there is the need for the book, once written, of a
> > single translator for the whole community content.
> >
> > Even everyone of us has English as a mother tongue or second tongue, we
> > may
> > able to reach and target new markets and new loyal fellows in this world
> > wide world we live in
> >
> > Cheers
> >
> >
> > Delfi Ramirez
> >
> > Segonquart Studio
> >
> > https://segonquart.net
> >
> > From: Oliver Rettig
> > Sent: 16 July 2018 13:47
> > To: dev@netbeans.incubator.apache.org
> > Subject: Re: Apache NetBeans Apress Book
> >
> > Hi all,
> >
> > I like the idea of a community-written book very much. This can encourage
> > people to join
> > our great community and it show that netbeans is now a apache project ...
> > For me the
> > community is one of the most important facts to work with netbeans and
> > rarely with eclipse.
> >
> > I have some experience with writing a book for Tomcat 5:
> >
> > https://www.rheinwerk-verlag.de/tomcat-5_700/
> >
> > and the most important thing I have learned from this book project is:
> > better not to write
> > such books alone.
> >
> > It would be a pleasure for me to write a chapter for a community-written
> > Netbeans book, or
> > may be to translate from english to german some parts, if we want to have
> > a
> > german
> > version.
> >
> > But I have less experience in organzing such things. In scientific
> > communities typically you
> > have an editor or a small team of editors. Their job is often really a
> lot
> > of work: to defines the
> > chapters/articles, to find people who can write the articles and to push
> > the
> > authors to deliver
> > in the timeline.
> >
> > An other question is where and how to publish the book. My experience
> with
> > the Tomcat
> > book was that the publisher was a really great help in formatting and
> > proofreading. And a
> > publisher can be a very big help in invertising for apache netbeans.
> >
> > But it should be also possible to write the book without a publisher at
> > our
> > own. In this case
> > we can have an open-pdf-Version of the book. Maye we can have this too
> > with
> > a publisher?
> >
> > best 

Re: Apache NetBeans Apress Book

2018-07-18 Thread Peter Steele
I had a look at Apress and there are quite a few books on netbeans (one
already that uses Netbeans 9 for its demos!). They all cost money
(unsurprisingly), I was wondering how that would fit in to a community
written book?

I don't have any expertise to add myself (I'm kind of waiting till things
stabilise to a standard development life cycle before investing some time
in to adding enhancements) but was interested in how it would work.

Is it better to actually just write a free book? Or do Apress bring a lot
to the venture?

On Wed, 18 Jul 2018 17:22 Mario Schroeder,  wrote:

> Hi Miloš,
>
> that what you describe is what I also thought about. I got an book about NB
> too, but the samples there don't use the annotations and some classes are
> even deprecated. So an update to the latest version of the platform would
> be great. I could be your copilot if you need help in reviews and
> correction.
>
> Regards,
> Mario
>
> Miloš Šilhánek  schrieb am Mi., 18. Juli 2018,
> 17:54:
>
> > Hi,
> > I was been interested some years ago in NetBeans Platform. I organized
> > translation from English to Czech and cowrote a NetBeans Platform
> > Cookbook
> > which were not realized - it is on NB wiki pages.
> >
> > So I leaved it - because of time and the need of application based on NB
> > Platform disappears in my work.
> > Now is all by browser. :-(. But NBP is suitable for many application as
> > the
> > showcase shows.
> >
> >
> >
> >
> > The book was made for NB 6.9.1 and tested for 7.1. Many features were
> > moved
> > to annotations in this time. We both had no time to upgrade it.
> >
> >
> >
> >
> > My English is poor so I could upgrade these examples or test new
> examples.
> >
> > Milos
> >
> >
> >
> >
> >
> > -- Původní e-mail --
> > Od: Delfi Ramirez 
> > Komu: dev@netbeans.incubator.apache.org <
> dev@netbeans.incubator.apache.org
> > >
> > Datum: 16. 7. 2018 13:56:18
> > Předmět: RE: Apache NetBeans Apress Book
> > "Hi All:
> >
> > Agreed there is the need of a chapter-by-chapter community written book.
> >
> > Count me in. Even if there is the need for the book, once written, of a
> > single translator for the whole community content.
> >
> > Even everyone of us has English as a mother tongue or second tongue, we
> > may
> > able to reach and target new markets and new loyal fellows in this world
> > wide world we live in
> >
> > Cheers
> >
> >
> > Delfi Ramirez
> >
> > Segonquart Studio
> >
> > https://segonquart.net
> >
> > From: Oliver Rettig
> > Sent: 16 July 2018 13:47
> > To: dev@netbeans.incubator.apache.org
> > Subject: Re: Apache NetBeans Apress Book
> >
> > Hi all,
> >
> > I like the idea of a community-written book very much. This can encourage
> > people to join
> > our great community and it show that netbeans is now a apache project ...
> > For me the
> > community is one of the most important facts to work with netbeans and
> > rarely with eclipse.
> >
> > I have some experience with writing a book for Tomcat 5:
> >
> > https://www.rheinwerk-verlag.de/tomcat-5_700/
> >
> > and the most important thing I have learned from this book project is:
> > better not to write
> > such books alone.
> >
> > It would be a pleasure for me to write a chapter for a community-written
> > Netbeans book, or
> > may be to translate from english to german some parts, if we want to have
> > a
> > german
> > version.
> >
> > But I have less experience in organzing such things. In scientific
> > communities typically you
> > have an editor or a small team of editors. Their job is often really a
> lot
> > of work: to defines the
> > chapters/articles, to find people who can write the articles and to push
> > the
> > authors to deliver
> > in the timeline.
> >
> > An other question is where and how to publish the book. My experience
> with
> > the Tomcat
> > book was that the publisher was a really great help in formatting and
> > proofreading. And a
> > publisher can be a very big help in invertising for apache netbeans.
> >
> > But it should be also possible to write the book without a publisher at
> > our
> > own. In this case
> > we can have an open-pdf-Version of the book. Maye we can have this too
> > with
> > a publisher?
> >
> > best regards
> > Oliver
> >
> >
> > > I've been approached by Apress regarding interest in a book on Apache
> > > NetBeans. I personally do not have enough time to devote to another
> book
> > > right now, so I wanted to send a note to the Apache NetBeans developer
> > > group to see if there are any developers interested in authoring a book
> > > (perhaps a collaborative effort).
> > >
> > > I know things are very busy right now, and I've already told Apress
> that
> > > the main focus is the release of Apache NetBeans 9 right now, but maybe
> > a
> > > book project could start this fall. There are no timelines right
> > > now...just interest in a book on the new open Apache NetBeans IDE.
> > >
> > > If anyone is interested then reply to this message and I can get 

Re: Apache NetBeans Apress Book

2018-07-18 Thread Mario Schroeder
Hi Miloš,

that what you describe is what I also thought about. I got an book about NB
too, but the samples there don't use the annotations and some classes are
even deprecated. So an update to the latest version of the platform would
be great. I could be your copilot if you need help in reviews and
correction.

Regards,
Mario

Miloš Šilhánek  schrieb am Mi., 18. Juli 2018, 17:54:

> Hi,
> I was been interested some years ago in NetBeans Platform. I organized
> translation from English to Czech and cowrote a NetBeans Platform
> Cookbook
> which were not realized - it is on NB wiki pages.
>
> So I leaved it - because of time and the need of application based on NB
> Platform disappears in my work.
> Now is all by browser. :-(. But NBP is suitable for many application as
> the
> showcase shows.
>
>
>
>
> The book was made for NB 6.9.1 and tested for 7.1. Many features were
> moved
> to annotations in this time. We both had no time to upgrade it.
>
>
>
>
> My English is poor so I could upgrade these examples or test new examples.
>
> Milos
>
>
>
>
>
> -- Původní e-mail --
> Od: Delfi Ramirez 
> Komu: dev@netbeans.incubator.apache.org  >
> Datum: 16. 7. 2018 13:56:18
> Předmět: RE: Apache NetBeans Apress Book
> "Hi All:
>
> Agreed there is the need of a chapter-by-chapter community written book.
>
> Count me in. Even if there is the need for the book, once written, of a
> single translator for the whole community content.
>
> Even everyone of us has English as a mother tongue or second tongue, we
> may
> able to reach and target new markets and new loyal fellows in this world
> wide world we live in
>
> Cheers
>
>
> Delfi Ramirez
>
> Segonquart Studio
>
> https://segonquart.net
>
> From: Oliver Rettig
> Sent: 16 July 2018 13:47
> To: dev@netbeans.incubator.apache.org
> Subject: Re: Apache NetBeans Apress Book
>
> Hi all,
>
> I like the idea of a community-written book very much. This can encourage
> people to join
> our great community and it show that netbeans is now a apache project ...
> For me the
> community is one of the most important facts to work with netbeans and
> rarely with eclipse.
>
> I have some experience with writing a book for Tomcat 5:
>
> https://www.rheinwerk-verlag.de/tomcat-5_700/
>
> and the most important thing I have learned from this book project is:
> better not to write
> such books alone.
>
> It would be a pleasure for me to write a chapter for a community-written
> Netbeans book, or
> may be to translate from english to german some parts, if we want to have
> a
> german
> version.
>
> But I have less experience in organzing such things. In scientific
> communities typically you
> have an editor or a small team of editors. Their job is often really a lot
> of work: to defines the
> chapters/articles, to find people who can write the articles and to push
> the
> authors to deliver
> in the timeline.
>
> An other question is where and how to publish the book. My experience with
> the Tomcat
> book was that the publisher was a really great help in formatting and
> proofreading. And a
> publisher can be a very big help in invertising for apache netbeans.
>
> But it should be also possible to write the book without a publisher at
> our
> own. In this case
> we can have an open-pdf-Version of the book. Maye we can have this too
> with
> a publisher?
>
> best regards
> Oliver
>
>
> > I've been approached by Apress regarding interest in a book on Apache
> > NetBeans. I personally do not have enough time to devote to another book
> > right now, so I wanted to send a note to the Apache NetBeans developer
> > group to see if there are any developers interested in authoring a book
> > (perhaps a collaborative effort).
> >
> > I know things are very busy right now, and I've already told Apress that
> > the main focus is the release of Apache NetBeans 9 right now, but maybe
> a
> > book project could start this fall. There are no timelines right
> > now...just interest in a book on the new open Apache NetBeans IDE.
> >
> > If anyone is interested then reply to this message and I can get a list
> of
>
> > names together to send along to Apress.
> >
> > Thanks
> >
> > Josh Juneau
> > juneau...@gmail.com
> > http://jj-blogger.blogspot.com
> > https://www.apress.com/index.php/author/author/view/id/1866
>
>
>
> "


RE: Apache NetBeans Apress Book

2018-07-18 Thread Miloš Šilhánek
Hi, 
I was been interested some years ago in NetBeans Platform. I organized
translation from English to Czech and cowrote a NetBeans Platform Cookbook 
which were not realized - it is on NB wiki pages. 

So I leaved it - because of time and the need of application based on NB 
Platform disappears in my work. 
Now is all by browser. :-(. But NBP is suitable for many application as the
showcase shows.




The book was made for NB 6.9.1 and tested for 7.1. Many features were moved
to annotations in this time. We both had no time to upgrade it.




My English is poor so I could upgrade these examples or test new examples.

Milos





-- Původní e-mail --
Od: Delfi Ramirez 
Komu: dev@netbeans.incubator.apache.org 
Datum: 16. 7. 2018 13:56:18
Předmět: RE: Apache NetBeans Apress Book
"Hi All:

Agreed there is the need of a chapter-by-chapter community written book. 

Count me in. Even if there is the need for the book, once written, of a 
single translator for the whole community content.

Even everyone of us has English as a mother tongue or second tongue, we may
able to reach and target new markets and new loyal fellows in this world 
wide world we live in

Cheers


Delfi Ramirez

Segonquart Studio

https://segonquart.net

From: Oliver Rettig
Sent: 16 July 2018 13:47
To: dev@netbeans.incubator.apache.org
Subject: Re: Apache NetBeans Apress Book

Hi all,

I like the idea of a community-written book very much. This can encourage 
people to join
our great community and it show that netbeans is now a apache project ... 
For me the
community is one of the most important facts to work with netbeans and
rarely with eclipse.

I have some experience with writing a book for Tomcat 5:

https://www.rheinwerk-verlag.de/tomcat-5_700/

and the most important thing I have learned from this book project is:
better not to write
such books alone.

It would be a pleasure for me to write a chapter for a community-written 
Netbeans book, or
may be to translate from english to german some parts, if we want to have a
german
version.

But I have less experience in organzing such things. In scientific
communities typically you
have an editor or a small team of editors. Their job is often really a lot
of work: to defines the
chapters/articles, to find people who can write the articles and to push the
authors to deliver
in the timeline.

An other question is where and how to publish the book. My experience with
the Tomcat
book was that the publisher was a really great help in formatting and
proofreading. And a
publisher can be a very big help in invertising for apache netbeans.

But it should be also possible to write the book without a publisher at our
own. In this case
we can have an open-pdf-Version of the book. Maye we can have this too with
a publisher?

best regards
Oliver


> I've been approached by Apress regarding interest in a book on Apache 
> NetBeans. I personally do not have enough time to devote to another book
> right now, so I wanted to send a note to the Apache NetBeans developer 
> group to see if there are any developers interested in authoring a book 
> (perhaps a collaborative effort).
>
> I know things are very busy right now, and I've already told Apress that
> the main focus is the release of Apache NetBeans 9 right now, but maybe a
> book project could start this fall. There are no timelines right
> now...just interest in a book on the new open Apache NetBeans IDE.
>
> If anyone is interested then reply to this message and I can get a list of

> names together to send along to Apress.
>
> Thanks
>
> Josh Juneau
> juneau...@gmail.com
> http://jj-blogger.blogspot.com
> https://www.apress.com/index.php/author/author/view/id/1866



"

Re: Does Travis and/or Jenkins run the NetBeans test suite?

2018-07-18 Thread Eirik Bakke
Looking at the "last stable build" of incubator-netbeans-linux, this one 
reports "no failures", yet has a failure in org.netbeans.junit.OrderHid.testSnd 
(and a few more also in the nbjunit module):

https://builds.apache.org/job/incubator-netbeans-linux/480

Is there somehting special about the nbjunit module that makes Jenkins ignore 
test failures there, and only there? (I don't see it in the list of tests at 
https://builds.apache.org/job/incubator-netbeans-linux/480/testReport/ .)

These Jenkins builds also omit all the tests in the "ide" cluster, right? E.g. 
most of the editor.* modules? When I run tests in editor.lib2 myself, I get 
several errors [1]. I'm trying to figure out whether this is due to my own 
setup, or whether it's a problem in the codebase itself.

-- Eirik
[1] All which boil down to "task failed due to: java.lang.NoClassDefFoundError: 
org/netbeans/editor/GuardedDocument", e.g. in 
org.netbeans.modules.editor.lib2.highlighting.HighlightingManagerTest . Seems 
like something I'm doing wrong with the build--unless there's an error in a 
static initializer somewhere. I tried a clean build of the entire 
incubator-netbeans repo, both on MacOS and Windows. I used "ant 
-Dtest-unit-sys-prop.ignore.random.failures=true -Dtest.modules=editor.lib2 
test" and inspected the output for failures.

On 7/18/18, 6:24 AM, "Jaroslav Tulach" 
mailto:jaroslav.tul...@gmail.com>> wrote:

FYI:
https://builds.apache.org/job/incubator-netbeans-linux/
and
https://builds.apache.org/job/incubator-netbeans-windows
run platform tests.

-jt


Dne neděle 15. července 2018 18:47:51 CEST, Eirik Bakke napsal(a):
When I make a pull request on GitHub, there is a nice little checkmark
saying "All checks have passed", with a link to a Travis CI build (e.g.
https://travis-ci.org/apache/incubator-netbeans/builds/395547620?utm_source
=github_status_medium=notification ).
Looking at the raw output of the Travis build, am I correct that this does
_not_ actually run the NetBeans test suite? I searched the console output
and did not find expected messages such as "Tests run:" or "do-junit" or
"[junit]".
Is this also the case for the Jenkins builds at
https://builds.apache.org/view/Incubator%20Projects/job/incubator-netbeans-> 
release ?
Is the current codebase supposed to pass all tests at this point? When I
check out the 9.0-vc3 tag, for instance, both of the following fail with
various errors:
ant commit-validation
ant -Dtest-unit-sys-prop.ignore.random.failures=true test
Are these supposed to work?
-- Eirik







Re: Public vs. Friend API?

2018-07-18 Thread Peter Nabbefeld



Am 14.07.2018 um 23:14 schrieb Tim Boudreau:

On Sat, Jul 14, 2018 at 6:23 AM Neil C Smith  wrote:


On Sat, 14 Jul 2018 at 05:41, Tim Boudreau  wrote:

I was there when friend APIs were being invented.  The *entire* purpose

was

for a developer to evolve an API,

Well, fair enough, can't argue with that (although I'd argue there are
uses now that aren't for that purpose).  Still seems the wrong way
around to me in comparison to other things I've worked with.


IMO, there *is no such thing as a "true friend" API.*  If you don't want

to

publish an API, put all of your code in one module - the compatibility
contract is between that module and itself.  If module X depends on

module

Y, and nothing else may depend on Y, and X cannot function without Y,

then

you have *a single logical module.*  You might think it looks nicer

carved

up into two pieces, but at that point you're doing code feng shui, not
engineering.

There are other reasons for using more than one module where you
*never* intend to create a public API, but need other aspects of the
module system - optionally loaded parts, OS-specific parts, etc.  So I
*am* thinking of a small number of things that are logically a unit.


True that things like OS-specific pieces are a special case.  Optional
seems iffy (unless it's huge, just bundle it but don't load it if you don't
need it).

But I think there's also a bit of social nudging any infrastructure around
this inevitably does - and a solution where creating a public, maintained
API with a commitment to backward compatibility is the path of least
resistance is going to have far more benefits for the project as a whole
than one where creating permanent friend APIs is the path of least
resistance, and that's what the existing way of doing things has gotten us.



If you have "non-stable dependencies", eventually that is all that will
exist.  Nobody would prefer to keep compatibility if they don't have to.

Well, that's a pessimistic viewpoint! ;-)


19 years working on or involved in a project will do that :-)

But seriously, if you have a shifting team of developers over a period of
years, the best guarantee that the things you want to happen on an ongoing
basis are remembered is if there is automation and infrastructure that
makes them a natural part of doing work.  Otherwise you're relying on
institutional knowledge and someone having the time and concern to do it.
I've seen "please make my module a friend of X" bugs languish for 6-9
months simply because it wasn't someone's priority, and they were working
for someone who didn't see it as a priority either.  If it's "hey we better
stabilize this or we've got to live with it as-is", that makes it a
priority, like it or not.



   But I agree with you that
time-limiting instability is probably a good idea.  And if optionally
installed modules can only be installed against a single release
(major/minor not point) of the IDE (and perhaps show a big warning
dialog to that fact) I think you'd see things pushed to become stable.


You can.  If you're writing an IDE module, your users can't.  They just
upgrade the IDE and find something doesn't work anymore, say "this sucks"
and go download Eclipse.

I'd argue that the friend system has made that problem worse not
better.  Assuming in-development API's don't change via automatic
updates as opposed to manual upgrade, then I don't see the issue here.
With the friend API you either don't have the module in the first
place, or a module that's had to hack its way into working in such a
way that it's more prone to breakage?!


Agree that it doesn't help much - heck, just recently I was playing with
Rust and found someone's Rust plugin on Github, which uses a ton of friend
and implementation dependencies that are broken, and rather than dig into
it I gave up.

A process that time-limits "unstable" APIs would fix that.

-Tim

While I appriciate the idea of automatically propagating API state from 
instable/friend to stable after some time, there may also be less APIs 
as a result. So probably there should be some group of people, e.g. QA 
team, deciding on where APIs should be defined. Then an API should be 
defined and reviewed, say version 0.1 (to express it's still early alpha 
stage).


This API should then be implemented and further discussed (You'll 
probably see during implementation what can be handled better some other 
way, or simply where the specification is incomplete, erroneous or just 
unspecified).


Another issue is still module splitting - bigger feature implementations 
are often splitted into several modules, which need the ability to 
privately access each other. This also results in some mismatch: 
Sometimes it would be nice to be able to expose some APIs as 
friend-only, while others are interesting for public usage. Currently, 
only either export is possible. While one can split the exporting module 
once more, this is probably not always convenient - probably this should 
be fixed. 

Re: Apache NetBeans Apress Book

2018-07-18 Thread John Kostaras
Hallo Josh,

I'm interested in taking this role if no other more experience wishes to do
so (e.g. Geertjan :) ). I always have to find the time but this is a
constant problem.

In the mean time, how are the authors going to collaborate? Does Apress
provide a collaboration platform for co-authoring, or are we going to find
an opensource solution (like e.g. github.io or something) making sure that
the work is not public to the internet?

Regards,

John.





On Tue, 17 Jul 2018 at 22:58, Josh Juneau  wrote:

> I've just briefly touched base with Apress on the idea and the editor I
> spoke to sounds very interested.  He says that they can divide the book up
> amongst any number of authors, and also do bylines for each of the chapters
> so that the respective authors will be noted.  Typically in this situation
> there is one person who acts as the lead on the project.  That way the
> editors and project coordinators at Apress can work with the lead, rather
> than all of the separate authors.
>
> Anyone interested in taking lead on the book?  If so then I can get you in
> touch with the editor and we can get the details of each author/chapter,
> etc. worked out.
>
> Thanks
>
> Josh Juneau
> juneau...@gmail.com
> http://jj-blogger.blogspot.com
> https://www.apress.com/index.php/author/author/view/id/1866
>
> > On Jul 17, 2018, at 3:40 AM, Delfi Ramirez 
> wrote:
> >
> > +1 Huang Kai 
> >
> > A wonder of myself to the community. Is there exist any intention or
> interest to include JSF in the topics -- chapters, subchapters -- of the
> book?
> >
> > Cheers
> >
> > Delfi Ramirez
> >
> > Segonquart Studio
> >
> > https://segonquart.net
> >
> > From: huang kai
> > Sent: 17 July 2018 10:30
> > To: dev@netbeans.incubator.apache.org
> > Subject: Re: Apache NetBeans Apress Book
> >
> > Hi, all
> >
> > I live in china and have been using netbeans for swing and java ee dev
> > for about 10 years. I think I can help translate the book to chinese,
> > let's make this great platform speading more faster.
> >
> > cheers.
> >
> > Kain Huang
> >
> >
> >> On 7/16/2018 7:53 PM, Delfi Ramirez wrote:
> >> Hi All:
> >>
> >> Agreed there is the  need of a chapter-by-chapter community written
> book.
> >>
> >> Count me in. Even if there is the need for the book, once written,  of
> a single translator for the whole community content.
> >>
> >> Even everyone of us has English as a mother tongue or second tongue, we
> may able to reach and target new markets and new loyal fellows in this
> world wide world we live in
> >>
> >> Cheers
> >>
> >>
> >> Delfi Ramirez
> >>
> >> Segonquart Studio
> >>
> >> https://segonquart.net
> >>
> >> From: Oliver Rettig
> >> Sent: 16 July 2018 13:47
> >> To: dev@netbeans.incubator.apache.org
> >> Subject: Re: Apache NetBeans Apress Book
> >>
> >> Hi all,
> >>
> >> I like the idea of a  community-written book very much. This can
> encourage people to join
> >> our great community and it show that netbeans is now a apache project
> ... For me the
> >> community is one of the most important facts to work with netbeans and
> rarely with eclipse.
> >>
> >> I have some experience with writing a book for Tomcat 5:
> >>
> >> https://www.rheinwerk-verlag.de/tomcat-5_700/
> >>
> >> and the most important thing I have learned from this book project is:
> better not to write
> >> such books alone.
> >>
> >> It would be a pleasure for me to write a chapter for a
> community-written Netbeans book, or
> >> may be to translate from english to german some parts, if we want to
> have a german
> >> version.
> >>
> >> But I have less experience in organzing such things. In scientific
> communities typically you
> >> have an editor or a small team of editors. Their job is often really a
> lot of work: to defines the
> >> chapters/articles, to find people who can write the articles and to
> push the authors to deliver
> >> in the timeline.
> >>
> >> An other question is where and how to publish the book. My experience
> with the Tomcat
> >> book was that the publisher was a really great help in formatting and
> proofreading. And a
> >> publisher can be a very big help in invertising for apache netbeans.
> >>
> >> But it should be also possible to write the book without a publisher at
> our own. In this case
> >> we can have an open-pdf-Version of the book. Maye we can have this too
> with a publisher?
> >>
> >> best regards
> >> Oliver
> >>
> >>
> >>> I've been approached by Apress regarding interest in a book on Apache
> >>> NetBeans.  I personally do not have enough time to devote to another
> book
> >>> right now, so I wanted to send a note to the Apache NetBeans developer
> >>> group to see if there are any developers interested in authoring a book
> >>> (perhaps a collaborative effort).
> >>>
> >>> I know things are very busy right now, and I've already told Apress
> that
> >>> the main focus is the release of Apache NetBeans 9 right now, but
> maybe a
> >>> book project could start this fall.  There are no timelines 

Re: Does Travis and/or Jenkins run the NetBeans test suite?

2018-07-18 Thread Sven Reimers
That would be good... I an interested in doing this for Groovy Support as
well... maybe we can figure out a standard  way how to do this.

-Sven


Jan Lahoda  schrieb am Mi., 18. Juli 2018, 08:05:

> FWIW, I'd like to set-up testing of the java.completion module on various
> JDKs (and eventually other Java-related modules), but I didn't get to that
> yet.
>
> Jan
>
> On Wed, Jul 18, 2018 at 6:24 AM, Jaroslav Tulach <
> jaroslav.tul...@gmail.com>
> wrote:
>
> > FYI:
> > https://builds.apache.org/job/incubator-netbeans-linux/
> > and
> > https://builds.apache.org/job/incubator-netbeans-windows
> > run platform tests.
> >
> > -jt
> >
> >
> > Dne neděle 15. července 2018 18:47:51 CEST, Eirik Bakke napsal(a):
> > > When I make a pull request on GitHub, there is a nice little checkmark
> > > saying "All checks have passed", with a link to a Travis CI build (e.g.
> > > https://travis-ci.org/apache/incubator-netbeans/builds/
> > 395547620?utm_source
> > > =github_status_medium=notification ).
> > >
> > > Looking at the raw output of the Travis build, am I correct that this
> > does
> > > _not_ actually run the NetBeans test suite? I searched the console
> output
> > > and did not find expected messages such as "Tests run:" or "do-junit"
> or
> > > "[junit]".
> > >
> > > Is this also the case for the Jenkins builds at
> > > https://builds.apache.org/view/Incubator%20Projects/job/
> > incubator-netbeans-> release ?
> > >
> > > Is the current codebase supposed to pass all tests at this point? When
> I
> > > check out the 9.0-vc3 tag, for instance, both of the following fail
> with
> > > various errors:
> > >
> > > ant commit-validation
> > > ant -Dtest-unit-sys-prop.ignore.random.failures=true test
> > >
> > > Are these supposed to work?
> > >
> > > -- Eirik
> >
> >
> >
> >
> >
> > -
> > To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org
> > For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>