You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@netbeans.apache.org by Richard <rg...@gmail.com> on 2021/03/06 18:54:45 UTC
[Netbeans Platform] Tutorials are unusable since transition to Apache
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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Re: [Netbeans Platform] Tutorials are unusable since
transition to Apache
Posted by Eric Bresie <eb...@gmail.com>.
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
Ebresie@gmail.com (mailto:Ebresie@gmail.com)
> On March 6, 2021 at 1:58:57 PM CST, Geertjan Wielenga <geertjan.wielenga@googlemail.com.invalid (mailto:geertjan.wielenga@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 <rgrenon17@gmail.com (mailto:rgrenon17@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 <geertjan.wielenga@googlemail.com (mailto:geertjan.wielenga@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 <rgrenon17@gmail.com (mailto:rgrenon17@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-unsubscribe@netbeans.apache.org (mailto:users-unsubscribe@netbeans.apache.org)
> > > > For additional commands, e-mail: users-help@netbeans.apache.org (mailto:users-help@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
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
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 <sl...@slipbits.com> 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.wielenga@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 <rg...@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-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: users-help@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
Posted by slipbits <sl...@slipbits.com>.
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 <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, Geertjan Wielenga
> <geertjan.wielenga@googlemail.com
> <ma...@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 <rgrenon17@gmail.com
> <ma...@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
> <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
> <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
> <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-unsubscribe@netbeans.apache.org
> <ma...@netbeans.apache.org>
> For additional commands, e-mail:
> users-help@netbeans.apache.org
> <ma...@netbeans.apache.org>
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> <https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists>
>
Re: [Netbeans Platform] Tutorials are unusable since transition to
Apache
Posted by "fruitpi@yahoo.co.uk.INVALID" <fr...@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 <ge...@googlemail.com.invalid> 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 <rg...@gmail.com> 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 <rg...@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. 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 <ge...@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 <rg...@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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@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
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
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 <rg...@gmail.com> 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 <rg...@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. 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.wielenga@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 <rg...@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-unsubscribe@netbeans.apache.org
>>>> For additional commands, e-mail: users-help@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
Posted by Richard <rg...@gmail.com>.
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 <rgrenon17@gmail.com
> <ma...@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. 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, Geertjan Wielenga
> <geertjan.wielenga@googlemail.com
> <ma...@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 <rgrenon17@gmail.com
> <ma...@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-unsubscribe@netbeans.apache.org
> <ma...@netbeans.apache.org>
> For additional commands, e-mail:
> users-help@netbeans.apache.org
> <ma...@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
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
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 <rg...@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. 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.wielenga@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 <rg...@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-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: users-help@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
Posted by Richard Grenon <rg...@gmail.com>.
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.wielenga@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 <rg...@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-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: users-help@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
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
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 <rg...@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-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>