[12:23:02] [[Tech]]; Tacsipacsi; this page is for requests about Wikimedia wikis, please read before writing; https://meta.wikimedia.org/w/index.php?diff=26342319&oldid=26337173&rcid=30277328 [18:39:28] apaskulin: I'm wondering if you know of a way to make identifiers become a link in JS docs? I thoguht I was doing it "wrong" but I can't seem to find any way that actually works? [18:39:45] Example is https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addCSS where `mw.loader#addStyleTag` is mentioned [18:40:12] I tried changing that locally to mw.loader.addStyleTag since that's how its formatted on the destination page and in search completion, but doesn't seem to make a difference. [18:41:38] likewise the link from load() to using() at https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.load I figured some way exists. That is, a way other than [](@link ) which I assumem is reserved for when it's really important / unnatural to mention the full name. I'm hoping there's still a way. [18:42:09] I had this same question the other day. I need to add this to the docs on wiki. Did you try `(@link mw.loader#addStyleTag}`? [18:42:38] oops should be `{@link mw.loader#addStyleTag}` [18:44:26] that works, but is not a natural thing to do in writing comments when you're writing it first party (i.e. among maintainers where humans and IDEs understand it directly). I don't see a future in which that will be done for every casual mention of a method or class in writing, which is to me half the power of generated docs. [18:44:40] seems urls aren't linked either at https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.percentDecodeFragment [18:44:52] I suspect this may have actually worked in an earlier draft of jsdoc theme [18:45:03] mayve we accidentally disabled some kind of linking plugin or option [18:45:36] @link shoudl imho be a last sort. [18:45:36] This is not a valid link [18:45:40] Thanks wm-bot [18:45:40] Hey Krinkle, you are welcome! [18:46:14] that's a good point. there is this https://github.com/wikimedia/jsdoc-wmf-theme/blob/master/betterlinks.js which, as far as I can tell, isn't getting actually used [18:48:06] I don't mind using @link here and there, but in practice it will mean there will be far fewer links. [18:48:54] I can see why it might be hard though since if it does a single pass, then at the time of parsing the doc block, it can't know which words are and aren't links. So it'd have to be in a second pass once it knows all the module names and such. Seems doable though, I think some jsdoc sites do do that. [18:50:12] That makes sense. It would be a better writing experience for sure. I'll open a task for it [18:54:28] https://phabricator.wikimedia.org/T359210