Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[frui...@yahoo.co.uk.INVALID]

 I am also a newbie to NetBeans and I would like to use it for C/C++, and I am 
actually having a bit of success though with one or two snags.If I could find 
tutorials covering general, language independent, use of the Netbeans interface 
and also basic C/C++ use I would give them a go.I cannot promise to give 
feedback, but I will try.
RegardsFruitpi

On Saturday, 6 March 2021, 23:28:57 GMT, Geertjan Wielenga 
 wrote:  
 
 Because on GitHub, the format and language used is Asciidoc, not HTML. And 
that is where the tutorials are now, on GitHub. We created a tool that converts 
from HTML to Asciidoc and that process did not go perfectly, so the screenshots 
are messed up, and we need to manually fix that.
Indeed, pointing out errors in the doc is a BIG contribution. And, sure, the 
users list is fine for that.
The more mails you send, ideally one mail per tutorial, the more of a 
contributor you will be to Apache NetBeans.
Gj
On Sun, Mar 7, 2021 at 12:23 AM Richard  wrote:

  Thank you all for your answers and the links.
 
 Geertjan, I do not understand why the transfer to Apache is so complex and 
needs to change from html format to asciidoc format, thus removing the 
screenshots, but this is beyond the scope of this mail. Of course, screenshots 
are welcome, but not needed if the text of the tutorial gives enough details 
and is OK. Thank you for the cleaned piece of code, I could rebuild and run the 
XML tutorial.
 
 I cannot contribute to improve tutorials if I do not understand them, as my 
knowledge in Java and Netbeans is rather low. But I consider that pointing out 
errors in the doc is also a contribution. Maybe the users list is not the right 
place to do that, but I don't want to do anymore and create a new account on 
github in order to contribute, at least until I have a better knowledge to be 
efficient.
 
 Maybe you think that I am only a "consumer", but I am still at the learning 
stage with the Netbeans Platform. I am reading the nbp4beginners book, and I 
need also good tutorials. But you can't say that I am only a "consumer" : I 
know what is an open source project and a community, and I am a contributor for 
the community of Apache OpenOffice and LibreOffice users for which I spent most 
of my free time using Netbeans to develop and update a JavaDesktop tool that 
helps to repair corrupted documents (ODFRepar tool).
 
 Richard
 
 Le 06/03/2021 à 20:58, Geertjan Wielenga a écrit :
  
Everything as it was before worked fine for you. Not for me. :-) I was 
working on them all on my own -- and that is not how open source is supposed to 
work.  
  We're in Apache now, which means you get involved -- you don't say "I do not 
know where and how to fill an issue", instead you say: "Where do I go and how 
do I fill out an issue?" 
  And that is here: 
  
https://issues.apache.org/jira/projects/NETBEANS/issues/NETBEANS-5397?filter=allopenissues
  
  Also, all the tutorials are now on GitHub. Including the one you're referring 
to: 
  
https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-xmleditor.asciidoc
  
  I've already fixed the broken code via this pull request, as a result of your 
mail: 
  https://github.com/apache/netbeans-website/pull/532
  
  Nothing here is "rather disappointing" -- everything is in progress, 
including the tutorials. The big difference now is that you're in a project 
where you're no longer a consumer, you're a contributor. 
  Yes, the tutorials have been transferred from HTML to Asciidoc on GitHub and 
the process is far from complete. Your mail has motivated me to commit to 
working on one of the NetBeans Platform tutorials per day, it will take a while 
to get everything up to scratch -- and a simple copy and paste of the tutorials 
would not have done the trick, since the old ones were HTML and the new ones 
are Asciidoc on GitHub -- so that you can now contribute too. 
  Welcome to Apache. :-) 
  Gj 
  
  On Sat, Mar 6, 2021 at 8:51 PM Richard Grenon  wrote:
  
 Hello Geertjan. 
 Netbeans Platform concepts are not easy to understand (I have purchased the 
book for beginners), and wrong tutorials are rather discouraging.  
  I do not know where and how to fill an issue, and I discovered the problem 
for the XML editor tutorial this evening. The old tutorial has gone and the new 
one is wrong. You can have a look on this tutorial that is rather short.  
  Only the first screenshot for creating the project is correct. All following 
screenshots do not follow the text, and some of them seem to be from other 
applications.  
  Finally, the short piece of code given for the method is melted with html 
links, so it is unreadable. 
  I cannot provide correct screenshots and code because I have erased my first 
test of this tutorial, and the html page with the correct old version of the 
tutorial has gone. 
  I do not know if other Apache tutorials are wrong, but the transfer of this 
one is rather 

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Geertjan Wielenga]

Because on GitHub, the format and language used is Asciidoc, not HTML. And
that is where the tutorials are now, on GitHub. We created a tool that
converts from HTML to Asciidoc and that process did not go perfectly, so
the screenshots are messed up, and we need to manually fix that.

Indeed, pointing out errors in the doc is a BIG contribution. And, sure,
the users list is fine for that.

The more mails you send, ideally one mail per tutorial, the more of a
contributor you will be to Apache NetBeans.

Gj

On Sun, Mar 7, 2021 at 12:23 AM Richard  wrote:

> Thank you all for your answers and the links.
>
> Geertjan, I do not understand why the transfer to Apache is so complex and
> needs to change from html format to asciidoc format, thus removing the
> screenshots, but this is beyond the scope of this mail. Of course,
> screenshots are welcome, but not needed if the text of the tutorial gives
> enough details and is OK. Thank you for the cleaned piece of code, I could
> rebuild and run the XML tutorial.
>
> I cannot contribute to improve tutorials if I do not understand them, as
> my knowledge in Java and Netbeans is rather low. But I consider that
> pointing out errors in the doc is also a contribution. Maybe the users list
> is not the right place to do that, but I don't want to do anymore and
> create a new account on github in order to contribute, at least until I
> have a better knowledge to be efficient.
>
> Maybe you think that I am only a "consumer", but I am still at the
> learning stage with the Netbeans Platform. I am reading the nbp4beginners
> book, and I need also good tutorials. But you can't say that I am only a
> "consumer" : I know what is an open source project and a community, and I
> am a contributor for the community of Apache OpenOffice and LibreOffice
> users for which I spent most of my free time using Netbeans to develop and
> update a JavaDesktop tool that helps to repair corrupted documents
> (ODFRepar tool).
>
> Richard
>
> Le 06/03/2021 à 20:58, Geertjan Wielenga a écrit :
>
> Everything as it was before worked fine for you. Not for me. :-) I was
> working on them all on my own -- and that is not how open source is
> supposed to work.
>
> We're in Apache now, which means you get involved -- you don't say "I do
> not know where and how to fill an issue", instead you say: "Where do I go
> and how do I fill out an issue?"
>
> And that is here:
>
>
> https://issues.apache.org/jira/projects/NETBEANS/issues/NETBEANS-5397?filter=allopenissues
>
> Also, all the tutorials are now on GitHub. Including the one you're
> referring to:
>
>
> https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-xmleditor.asciidoc
>
> I've already fixed the broken code via this pull request, as a result of
> your mail:
>
> https://github.com/apache/netbeans-website/pull/532
>
> Nothing here is "rather disappointing" -- everything is in progress,
> including the tutorials. The big difference now is that you're in a project
> where you're no longer a consumer, you're a contributor.
>
> Yes, the tutorials have been transferred from HTML to Asciidoc on GitHub
> and the process is far from complete. Your mail has motivated me to commit
> to working on one of the NetBeans Platform tutorials per day, it will take
> a while to get everything up to scratch -- and a simple copy and paste of
> the tutorials would not have done the trick, since the old ones were HTML
> and the new ones are Asciidoc on GitHub -- so that you can now contribute
> too.
>
> Welcome to Apache. :-)
>
> Gj
>
>
> On Sat, Mar 6, 2021 at 8:51 PM Richard Grenon  wrote:
>
>> Hello Geertjan.
>>
>> Netbeans Platform concepts are not easy to understand (I have purchased
>> the book for beginners), and wrong tutorials are rather discouraging.
>>
>> I do not know where and how to fill an issue, and I discovered the
>> problem for the XML editor tutorial this evening. The old tutorial has gone
>> and the new one is wrong. You can have a look on this tutorial that is
>> rather short.
>>
>> Only the first screenshot for creating the project is correct. All
>> following screenshots do not follow the text, and some of them seem to be
>> from other applications.
>>
>> Finally, the short piece of code given for the method is melted with html
>> links, so it is unreadable.
>>
>> I cannot provide correct screenshots and code because I have erased my
>> first test of this tutorial, and the html page with the correct old version
>> of the tutorial has gone.
>>
>> I do not know if other Apache tutorials are wrong, but the transfer of
>> this one is rather disappointing. Why the old version from netbeans.org
>> has not been simply copied to a new Apache page rather than rewritten with
>> errors ? For me, correcting the tutorial would be simply to provide a link
>> pointing on the old version.
>>
>> So the question is : where can we find all the tutorials from the old
>> netbeans.org?
>>
>> Richard
>>
>> Le sam. 6 mars 

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Richard]

Thank you all for your answers and the links.

Geertjan, I do not understand why the transfer to Apache is so complex 
and needs to change from html format to asciidoc format, thus removing 
the screenshots, but this is beyond the scope of this mail. Of course, 
screenshots are welcome, but not needed if the text of the tutorial 
gives enough details and is OK. Thank you for the cleaned piece of code, 
I could rebuild and run the XML tutorial.


I cannot contribute to improve tutorials if I do not understand them, as 
my knowledge in Java and Netbeans is rather low. But I consider that 
pointing out errors in the doc is also a contribution. Maybe the users 
list is not the right place to do that, but I don't want to do anymore 
and create a new account on github in order to contribute, at least 
until I have a better knowledge to be efficient.


Maybe you think that I am only a "consumer", but I am still at the 
learning stage with the Netbeans Platform. I am reading the 
nbp4beginners book, and I need also good tutorials. But you can't say 
that I am only a "consumer" : I know what is an open source project and 
a community, and I am a contributor for the community of Apache 
OpenOffice and LibreOffice users for which I spent most of my free time 
using Netbeans to develop and update a JavaDesktop tool that helps to 
repair corrupted documents (ODFRepar tool).


Richard

Le 06/03/2021 à 20:58, Geertjan Wielenga a écrit :
Everything as it was before worked fine for you. Not for me. :-) I was 
working on them all on my own -- and that is not how open source is 
supposed to work.


We're in Apache now, which means you get involved -- you don't say "I 
do not know where and how to fill an issue", instead you say: "Where 
do I go and how do I fill out an issue?"


And that is here:

https://issues.apache.org/jira/projects/NETBEANS/issues/NETBEANS-5397?filter=allopenissues

Also, all the tutorials are now on GitHub. Including the one you're 
referring to:


https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-xmleditor.asciidoc

I've already fixed the broken code via this pull request, as a result 
of your mail:


https://github.com/apache/netbeans-website/pull/532

Nothing here is "rather disappointing" -- everything is in progress, 
including the tutorials. The big difference now is that you're in a 
project where you're no longer a consumer, you're a contributor.


Yes, the tutorials have been transferred from HTML to Asciidoc on 
GitHub and the process is far from complete. Your mail has motivated 
me to commit to working on one of the NetBeans Platform tutorials per 
day, it will take a while to get everything up to scratch -- and a 
simple copy and paste of the tutorials would not have done the trick, 
since the old ones were HTML and the new ones are Asciidoc on GitHub 
-- so that you can now contribute too.


Welcome to Apache. :-)

Gj


On Sat, Mar 6, 2021 at 8:51 PM Richard Grenon > wrote:


Hello Geertjan.

Netbeans Platform concepts are not easy to understand (I have
purchased the book for beginners), and wrong tutorials are rather
discouraging.

I do not know where and how to fill an issue, and I discovered the
problem for the XML editor tutorial this evening. The old tutorial
has gone and the new one is wrong. You can have a look on this
tutorial that is rather short.

Only the first screenshot for creating the project is correct. All
following screenshots do not follow the text, and some of them
seem to be from other applications.

Finally, the short piece of code given for the method is melted
with html links, so it is unreadable.

I cannot provide correct screenshots and code because I have
erased my first test of this tutorial, and the html page with the
correct old version of the tutorial has gone.

I do not know if other Apache tutorials are wrong, but the
transfer of this one is rather disappointing. Why the old version
from netbeans.org  has not been simply copied
to a new Apache page rather than rewritten with errors ? For me,
correcting the tutorial would be simply to provide a link pointing
on the old version.

So the question is : where can we find all the tutorials from the
old netbeans.org ?

Richard

Le sam. 6 mars 2021 à 20:05, Geertjan Wielenga
mailto:geertjan.wiele...@googlemail.com>> a écrit :


Which screenshots specifically are wrong — I’d be happy to
collaborate with you to work on the tutorials that you would
like fixed. If you create a new issue for each tutorial you’d
like to work together on, with very precise descriptions of
what is wrong, ideally providing the correct screenshot or
code, and otherwise just being precise in saying what should
be corrected, we can work on this together to 

Re: Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Eric Bresie]

Would this help any?

https://github.com/apache/netbeans-website/pull/533

Since the links in the index.asciidoc were referencing html and not new 
asciidoc file names, I swapped .html to .asciidoc

Eric Bresie
ebre...@gmail.com (mailto:ebre...@gmail.com)

> On March 6, 2021 at 1:58:57 PM CST, Geertjan Wielenga 
>  (mailto:geertjan.wiele...@googlemail.com.invalid)> wrote:
> Everything as it was before worked fine for you. Not for me. :-) I was 
> working on them all on my own -- and that is not how open source is supposed 
> to work.
>
> We're in Apache now, which means you get involved -- you don't say "I do not 
> know where and how to fill an issue", instead you say: "Where do I go and how 
> do I fill out an issue?"
>
> And that is here:
>
> https://issues.apache.org/jira/projects/NETBEANS/issues/NETBEANS-5397?filter=allopenissues
>
> Also, all the tutorials are now on GitHub. Including the one you're referring 
> to:
>
> https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-xmleditor.asciidoc
>
> I've already fixed the broken code via this pull request, as a result of your 
> mail:
>
> https://github.com/apache/netbeans-website/pull/532
>
> Nothing here is "rather disappointing" -- everything is in progress, 
> including the tutorials. The big difference now is that you're in a project 
> where you're no longer a consumer, you're a contributor.
>
> Yes, the tutorials have been transferred from HTML to Asciidoc on GitHub and 
> the process is far from complete. Your mail has motivated me to commit to 
> working on one of the NetBeans Platform tutorials per day, it will take a 
> while to get everything up to scratch -- and a simple copy and paste of the 
> tutorials would not have done the trick, since the old ones were HTML and the 
> new ones are Asciidoc on GitHub -- so that you can now contribute too.
>
> Welcome to Apache. :-)
>
> Gj
>
>
> On Sat, Mar 6, 2021 at 8:51 PM (x-apple-data-detectors://7) Richard Grenon 
> mailto:rgreno...@gmail.com)> wrote:
> > Hello Geertjan.
> >
> > Netbeans Platform concepts are not easy to understand (I have purchased the 
> > book for beginners), and wrong tutorials are rather discouraging.
> >
> > I do not know where and how to fill an issue, and I discovered the problem 
> > for the XML editor tutorial this evening (x-apple-data-detectors://9). The 
> > old tutorial has gone and the new one is wrong. You can have a look on this 
> > tutorial that is rather short.
> >
> > Only the first screenshot for creating the project is correct. All 
> > following screenshots do not follow the text, and some of them seem to be 
> > from other applications.
> >
> > Finally, the short piece of code given for the method is melted with html 
> > links, so it is unreadable.
> >
> > I cannot provide correct screenshots and code because I have erased my 
> > first test of this tutorial, and the html page with the correct old version 
> > of the tutorial has gone.
> >
> > I do not know if other Apache tutorials are wrong, but the transfer of this 
> > one is rather disappointing. Why the old version from netbeans.org 
> > (http://netbeans.org) has not been simply copied to a new Apache page 
> > rather than rewritten with errors ? For me, correcting the tutorial would 
> > be simply to provide a link pointing on the old version.
> >
> > So the question is : where can we find all the tutorials from the old 
> > netbeans.org (http://netbeans.org)?
> >
> > Richard
> > Le sam. 6 mars 2021 à 20:05 (x-apple-data-detectors://12), Geertjan 
> > Wielenga  > (mailto:geertjan.wiele...@googlemail.com)> a écrit :
> > >
> > > Which screenshots specifically are wrong — I’d be happy to collaborate 
> > > with you to work on the tutorials that you would like fixed. If you 
> > > create a new issue for each tutorial you’d like to work together on, with 
> > > very precise descriptions of what is wrong, ideally providing the correct 
> > > screenshot or code, and otherwise just being precise in saying what 
> > > should be corrected, we can work on this together to improve the 
> > > tutorials in order of your preference.
> > >
> > > What do you think?
> > >
> > > Gj
> > >
> > > On Sat, 6 Mar 2021 at 19:54 (x-apple-data-detectors://14), Richard 
> > > mailto:rgreno...@gmail.com)> wrote:
> > > > Hello.
> > > >
> > > > Some days ago, I successfully performed a tutorial for XML Editor
> > > > extension. The link was :
> > > >
> > > > https://platform.netbeans.org/tutorials/nbm-xmleditor.html
> > > >
> > > > As I had removed this test from my disk, today I tried to perform again
> > > > this tutorial, but the link points now to :
> > > >
> > > > https://netbeans.apache.org/tutorials/nbm-xmleditor.html
> > > >
> > > > On this new link, the screenshots do not correspond to the text, and the
> > > > code given for the method "actionPerformed" is unreadable because it
> > > > contains links to javadoc html pages, and all these links point to the
> > > > Apache 

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Geertjan Wielenga]

That's nice but what's needed is that we pitch in and review the tutorials
together, please.

Your proposed solution here will entail that the tutorials will never get
updated -- unless you assume that I'll be doing that on my own without your
involvement?

Here's the one that's been discussed in this thread, the code is now
cleaned up and the images are removed:

https://netbeans.apache.org/tutorials/nbm-xmleditor.html

Anyone is welcome to work through the tutorial, create screenshots as you
go along, and provide a pull request to include them in the tutorial.

Now, which tutorial shall we work on next?

Gj

On Sat, Mar 6, 2021 at 10:23 PM slipbits  wrote:

> Don't know if this helps. Whenever I use a system, a.k.a, Netbeans, I
> attempt to download everything in site. Just because I spend most of life
> living under a rock with pretensions of paranoia. With this in mind, I have
> all the Netbeans documentation given with distributions (8.2, 9.0, 11.0,
> 12.2) and java documents including tutorials (8.2 et alia). They run to the
> 'to big to count' but if you'd like I'll try to figure out how to send a
> few.
>
> The Java XML stuff I have is:
>
> JDK_14/api/java.xml/javax/xml
> JDK_14/api/java.xml/org/xml
> JDK_14/api/java.xml.crypto/javax/xml
> JDK_8/api/javax/xml
> JDK_8/api/org/xml
> JDK_8/technotes/guides/xml
> tutorial/jdbc/basics/examples/JDBCTutorial/xml
>
> If this is helpful I'll zip it up.
>
> art
> On 3/6/2021 11:51 AM, Richard Grenon wrote:
>
> Hello Geertjan.
>
> Netbeans Platform concepts are not easy to understand (I have purchased
> the book for beginners), and wrong tutorials are rather discouraging.
>
> I do not know where and how to fill an issue, and I discovered the problem
> for the XML editor tutorial this evening. The old tutorial has gone and the
> new one is wrong. You can have a look on this tutorial that is rather
> short.
>
> Only the first screenshot for creating the project is correct. All
> following screenshots do not follow the text, and some of them seem to be
> from other applications.
>
> Finally, the short piece of code given for the method is melted with html
> links, so it is unreadable.
>
> I cannot provide correct screenshots and code because I have erased my
> first test of this tutorial, and the html page with the correct old version
> of the tutorial has gone.
>
> I do not know if other Apache tutorials are wrong, but the transfer of
> this one is rather disappointing. Why the old version from netbeans.org
> has not been simply copied to a new Apache page rather than rewritten with
> errors ? For me, correcting the tutorial would be simply to provide a link
> pointing on the old version.
>
> So the question is : where can we find all the tutorials from the old
> netbeans.org?
>
> Richard
>
> Le sam. 6 mars 2021 à 20:05, Geertjan Wielenga <
> geertjan.wiele...@googlemail.com> a écrit :
>
>>
>> Which screenshots specifically are wrong — I’d be happy to collaborate
>> with you to work on the tutorials that you would like fixed. If you create
>> a new issue for each tutorial you’d like to work together on, with very
>> precise descriptions of what is wrong, ideally providing the correct
>> screenshot or code, and otherwise just being precise in saying what should
>> be corrected, we can work on this together to improve the tutorials in
>> order of your preference.
>>
>> What do you think?
>>
>> Gj
>>
>> On Sat, 6 Mar 2021 at 19:54, Richard  wrote:
>>
>>> Hello.
>>>
>>> Some days ago, I successfully performed a tutorial for XML Editor
>>> extension. The link was :
>>>
>>> https://platform.netbeans.org/tutorials/nbm-xmleditor.html
>>>
>>> As I had removed this test from my disk, today I tried to perform again
>>> this tutorial, but the link points now to :
>>>
>>> https://netbeans.apache.org/tutorials/nbm-xmleditor.html
>>>
>>> On this new link, the screenshots do not correspond to the text, and the
>>> code given for the method "actionPerformed" is unreadable because it
>>> contains links to javadoc html pages, and all these links point to the
>>> Apache transition page :
>>>
>>> https://netbeans.apache.org/about/oracle-transition.html
>>>
>>> Please, could anybody check this tutorial (and maybe other tutorials) or
>>> provide a link to the correct old version ?
>>>
>>> Richard
>>>
>>> -
>>> To unsubscribe, e-mail: users-unsubscr...@netbeans.apache.org
>>> For additional commands, e-mail: users-h...@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[slipbits]

Don't know if this helps. Whenever I use a system, a.k.a, Netbeans, I 
attempt to download everything in site. Just because I spend most of 
life living under a rock with pretensions of paranoia. With this in 
mind, I have all the Netbeans documentation given with distributions 
(8.2, 9.0, 11.0, 12.2) and java documents including tutorials (8.2 et 
alia). They run to the 'to big to count' but if you'd like I'll try to 
figure out how to send a few.


The Java XML stuff I have is:

JDK_14/api/java.xml/javax/xml
JDK_14/api/java.xml/org/xml
JDK_14/api/java.xml.crypto/javax/xml
JDK_8/api/javax/xml
JDK_8/api/org/xml
JDK_8/technotes/guides/xml
tutorial/jdbc/basics/examples/JDBCTutorial/xml

If this is helpful I'll zip it up.

art

On 3/6/2021 11:51 AM, Richard Grenon wrote:

Hello Geertjan.

Netbeans Platform concepts are not easy to understand (I have 
purchased the book for beginners), and wrong tutorials are rather 
discouraging.


I do not know where and how to fill an issue, and I discovered the 
problem for the XML editor tutorial this evening. The old tutorial has 
gone and the new one is wrong. You can have a look on this tutorial 
that is rather short.


Only the first screenshot for creating the project is correct. All 
following screenshots do not follow the text, and some of them seem to 
be from other applications.


Finally, the short piece of code given for the method is melted with 
html links, so it is unreadable.


I cannot provide correct screenshots and code because I have erased my 
first test of this tutorial, and the html page with the correct old 
version of the tutorial has gone.


I do not know if other Apache tutorials are wrong, but the transfer of 
this one is rather disappointing. Why the old version from 
netbeans.org  has not been simply copied to a new 
Apache page rather than rewritten with errors ? For me, correcting the 
tutorial would be simply to provide a link pointing on the old version.


So the question is : where can we find all the tutorials from the old 
netbeans.org ?


Richard

Le sam. 6 mars 2021 à 20:05, Geertjan Wielenga 
> a écrit :



Which screenshots specifically are wrong — I’d be happy to
collaborate with you to work on the tutorials that you would like
fixed. If you create a new issue for each tutorial you’d like to
work together on, with very precise descriptions of what is wrong,
ideally providing the correct screenshot or code, and otherwise
just being precise in saying what should be corrected, we can work
on this together to improve the tutorials in order of your preference.

What do you think?

Gj

On Sat, 6 Mar 2021 at 19:54, Richard mailto:rgreno...@gmail.com>> wrote:

Hello.

Some days ago, I successfully performed a tutorial for XML Editor
extension. The link was :

https://platform.netbeans.org/tutorials/nbm-xmleditor.html


As I had removed this test from my disk, today I tried to
perform again
this tutorial, but the link points now to :

https://netbeans.apache.org/tutorials/nbm-xmleditor.html


On this new link, the screenshots do not correspond to the
text, and the
code given for the method "actionPerformed" is unreadable
because it
contains links to javadoc html pages, and all these links
point to the
Apache transition page :

https://netbeans.apache.org/about/oracle-transition.html


Please, could anybody check this tutorial (and maybe other
tutorials) or
provide a link to the correct old version ?

Richard

-
To unsubscribe, e-mail: users-unsubscr...@netbeans.apache.org

For additional commands, e-mail:
users-h...@netbeans.apache.org


For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Geertjan Wielenga]

Everything as it was before worked fine for you. Not for me. :-) I was
working on them all on my own -- and that is not how open source is
supposed to work.

We're in Apache now, which means you get involved -- you don't say "I do
not know where and how to fill an issue", instead you say: "Where do I go
and how do I fill out an issue?"

And that is here:

https://issues.apache.org/jira/projects/NETBEANS/issues/NETBEANS-5397?filter=allopenissues

Also, all the tutorials are now on GitHub. Including the one you're
referring to:

https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-xmleditor.asciidoc

I've already fixed the broken code via this pull request, as a result of
your mail:

https://github.com/apache/netbeans-website/pull/532

Nothing here is "rather disappointing" -- everything is in progress,
including the tutorials. The big difference now is that you're in a project
where you're no longer a consumer, you're a contributor.

Yes, the tutorials have been transferred from HTML to Asciidoc on GitHub
and the process is far from complete. Your mail has motivated me to commit
to working on one of the NetBeans Platform tutorials per day, it will take
a while to get everything up to scratch -- and a simple copy and paste of
the tutorials would not have done the trick, since the old ones were HTML
and the new ones are Asciidoc on GitHub -- so that you can now contribute
too.

Welcome to Apache. :-)

Gj


On Sat, Mar 6, 2021 at 8:51 PM Richard Grenon  wrote:

> Hello Geertjan.
>
> Netbeans Platform concepts are not easy to understand (I have purchased
> the book for beginners), and wrong tutorials are rather discouraging.
>
> I do not know where and how to fill an issue, and I discovered the problem
> for the XML editor tutorial this evening. The old tutorial has gone and the
> new one is wrong. You can have a look on this tutorial that is rather
> short.
>
> Only the first screenshot for creating the project is correct. All
> following screenshots do not follow the text, and some of them seem to be
> from other applications.
>
> Finally, the short piece of code given for the method is melted with html
> links, so it is unreadable.
>
> I cannot provide correct screenshots and code because I have erased my
> first test of this tutorial, and the html page with the correct old version
> of the tutorial has gone.
>
> I do not know if other Apache tutorials are wrong, but the transfer of
> this one is rather disappointing. Why the old version from netbeans.org
> has not been simply copied to a new Apache page rather than rewritten with
> errors ? For me, correcting the tutorial would be simply to provide a link
> pointing on the old version.
>
> So the question is : where can we find all the tutorials from the old
> netbeans.org?
>
> Richard
>
> Le sam. 6 mars 2021 à 20:05, Geertjan Wielenga <
> geertjan.wiele...@googlemail.com> a écrit :
>
>>
>> Which screenshots specifically are wrong — I’d be happy to collaborate
>> with you to work on the tutorials that you would like fixed. If you create
>> a new issue for each tutorial you’d like to work together on, with very
>> precise descriptions of what is wrong, ideally providing the correct
>> screenshot or code, and otherwise just being precise in saying what should
>> be corrected, we can work on this together to improve the tutorials in
>> order of your preference.
>>
>> What do you think?
>>
>> Gj
>>
>> On Sat, 6 Mar 2021 at 19:54, Richard  wrote:
>>
>>> Hello.
>>>
>>> Some days ago, I successfully performed a tutorial for XML Editor
>>> extension. The link was :
>>>
>>> https://platform.netbeans.org/tutorials/nbm-xmleditor.html
>>>
>>> As I had removed this test from my disk, today I tried to perform again
>>> this tutorial, but the link points now to :
>>>
>>> https://netbeans.apache.org/tutorials/nbm-xmleditor.html
>>>
>>> On this new link, the screenshots do not correspond to the text, and the
>>> code given for the method "actionPerformed" is unreadable because it
>>> contains links to javadoc html pages, and all these links point to the
>>> Apache transition page :
>>>
>>> https://netbeans.apache.org/about/oracle-transition.html
>>>
>>> Please, could anybody check this tutorial (and maybe other tutorials) or
>>> provide a link to the correct old version ?
>>>
>>> Richard
>>>
>>> -
>>> To unsubscribe, e-mail: users-unsubscr...@netbeans.apache.org
>>> For additional commands, e-mail: users-h...@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>>

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Richard Grenon]

Hello Geertjan.

Netbeans Platform concepts are not easy to understand (I have purchased the
book for beginners), and wrong tutorials are rather discouraging.

I do not know where and how to fill an issue, and I discovered the problem
for the XML editor tutorial this evening. The old tutorial has gone and the
new one is wrong. You can have a look on this tutorial that is rather
short.

Only the first screenshot for creating the project is correct. All
following screenshots do not follow the text, and some of them seem to be
from other applications.

Finally, the short piece of code given for the method is melted with html
links, so it is unreadable.

I cannot provide correct screenshots and code because I have erased my
first test of this tutorial, and the html page with the correct old version
of the tutorial has gone.

I do not know if other Apache tutorials are wrong, but the transfer of this
one is rather disappointing. Why the old version from netbeans.org has not
been simply copied to a new Apache page rather than rewritten with errors ?
For me, correcting the tutorial would be simply to provide a link pointing
on the old version.

So the question is : where can we find all the tutorials from the old
netbeans.org?

Richard

Le sam. 6 mars 2021 à 20:05, Geertjan Wielenga <
geertjan.wiele...@googlemail.com> a écrit :

>
> Which screenshots specifically are wrong — I’d be happy to collaborate
> with you to work on the tutorials that you would like fixed. If you create
> a new issue for each tutorial you’d like to work together on, with very
> precise descriptions of what is wrong, ideally providing the correct
> screenshot or code, and otherwise just being precise in saying what should
> be corrected, we can work on this together to improve the tutorials in
> order of your preference.
>
> What do you think?
>
> Gj
>
> On Sat, 6 Mar 2021 at 19:54, Richard  wrote:
>
>> Hello.
>>
>> Some days ago, I successfully performed a tutorial for XML Editor
>> extension. The link was :
>>
>> https://platform.netbeans.org/tutorials/nbm-xmleditor.html
>>
>> As I had removed this test from my disk, today I tried to perform again
>> this tutorial, but the link points now to :
>>
>> https://netbeans.apache.org/tutorials/nbm-xmleditor.html
>>
>> On this new link, the screenshots do not correspond to the text, and the
>> code given for the method "actionPerformed" is unreadable because it
>> contains links to javadoc html pages, and all these links point to the
>> Apache transition page :
>>
>> https://netbeans.apache.org/about/oracle-transition.html
>>
>> Please, could anybody check this tutorial (and maybe other tutorials) or
>> provide a link to the correct old version ?
>>
>> Richard
>>
>> -
>> To unsubscribe, e-mail: users-unsubscr...@netbeans.apache.org
>> For additional commands, e-mail: users-h...@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
>>

Re: [Netbeans Platform] Tutorials are unusable since transition to Apache

[Geertjan Wielenga]

Which screenshots specifically are wrong — I’d be happy to collaborate with
you to work on the tutorials that you would like fixed. If you create a new
issue for each tutorial you’d like to work together on, with very precise
descriptions of what is wrong, ideally providing the correct screenshot or
code, and otherwise just being precise in saying what should be corrected,
we can work on this together to improve the tutorials in order of your
preference.

What do you think?

Gj

On Sat, 6 Mar 2021 at 19:54, Richard  wrote:

> Hello.
>
> Some days ago, I successfully performed a tutorial for XML Editor
> extension. The link was :
>
> https://platform.netbeans.org/tutorials/nbm-xmleditor.html
>
> As I had removed this test from my disk, today I tried to perform again
> this tutorial, but the link points now to :
>
> https://netbeans.apache.org/tutorials/nbm-xmleditor.html
>
> On this new link, the screenshots do not correspond to the text, and the
> code given for the method "actionPerformed" is unreadable because it
> contains links to javadoc html pages, and all these links point to the
> Apache transition page :
>
> https://netbeans.apache.org/about/oracle-transition.html
>
> Please, could anybody check this tutorial (and maybe other tutorials) or
> provide a link to the correct old version ?
>
> Richard
>
> -
> To unsubscribe, e-mail: users-unsubscr...@netbeans.apache.org
> For additional commands, e-mail: users-h...@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>