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 <rgreno...@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 <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 >> 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 <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 >>>> >>>> >
