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
<[email protected]> 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 <[email protected]> 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 <[email protected]> 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
<[email protected]> 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 <[email protected]> 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: [email protected]
For additional commands, e-mail: [email protected]
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
