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 <rgreno...@gmail.com
<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. 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.wiele...@googlemail.com
<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, Richard <rgreno...@gmail.com
<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
<mailto:users-unsubscr...@netbeans.apache.org>
For additional commands, e-mail:
users-h...@netbeans.apache.org
<mailto:users-h...@netbeans.apache.org>
For further information about the NetBeans mailing lists,
visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
