On 9/27/25 11:22, Neil C Smith wrote: > On Fri, 26 Sept 2025 at 19:44, Michael Bien <[email protected]> wrote: >> agreed. I remember trying to remove some even more annoying occurrences >> of the template links for cases which leave even less design space for users >> but it got >> vetoed unfortunately. >> >> https://github.com/apache/netbeans/pull/3876 > And from that discussion it appears that better signposting to "new" > users that they need to hold down CTRL or CMD to make anything > clickable in the editor is still something we're missing out on! :-) > > Ken, that would actually be a useful thing to highlight early in your > book, as it's a key part of navigation around code and resources in > the editor. And there's a very obvious reason you don't want a normal > click to navigate anywhere in a text editor. > > This header change came from > https://github.com/apache/netbeans/pull/2960 Unfortunately, that only > partly made this "easier", because it also removed the important fact > that these things are managed from Tools / Templates and not Tools / > Options. this wasn't just the header, you will find those "please configure me" comments in more places which were generated by NB. (even lambda completion one-liners until #3458)
This is also no UI issue (!) as suggested elsewhere. The comment is in the file. Any attempt to fold it or make it render nicer will obfuscate the problem and likely make it worse: https://github.com/search?q=%22choose+Tools+%7C+Templates%22&type=code I question that the tutorial aspect outweighs the general annoyance those links cause. After all, good defaults are very important! The less someone has to configure to make a tool usable the better. IMO: neither the comment nor the link should exist, if this needs some kind of tutorial, it could be potentially solved via a hint or something like that which jumps to the template on activation if the cursor is in the top level file comment. NB doesn't have a help system anymore, its weird that out of all things which could be explained, code templates were prioritized so much that links are spammed into source code. A wiki article about code templates would probably help here more than anything else, esp after chat bots read it on their quest to replace web search. (If you search "NetBeans code templates" you likely land on an article which explains how to bundle them in a nbm) -mbien > > In particular, Tools / Templates - Licenses / Default License - Open > in Editor is I think what you're looking for? > > It's important to consider that these are also brandable. If one of > the reasons for the current text is still VSNetBeans, and that is not > working for the IDE, they do not have to be the same. > > Best wishes, > > Neil > > --------------------------------------------------------------------- > 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 > > > --------------------------------------------------------------------- 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
