Autolinking here on meta

Hello :blob_wave:

Quick question about what your thoughts are around our autolinking - do you find it useful, or do any of them get on your nerves? Are there any you’d wish to add, or even some you’d like to remove?

We currently have:

Let me know what you think. :slight_smile:

10 Likes

For obvious reasons, I would like to add:

  • official plugin(s)
  • official theme(s)
  • official theme component(s)
4 Likes

Where would they link? To pages like https://meta.discourse.org/tags/c/plugin/22/official ?

3 Likes

Both.

I find it useful when I use them in posts. For example, I can easily ask “Have you tried safe mode?” and there is no need to manually add the link which explains what safe-mode is and how to use it. Though I would sometimes prefer a template, because I tend to write “safe-mode” and at the moment I have to use the preview to check whether I used the correct spelling. So I could suggest adding safe-mode but I like that I can reduce the number of links by using a different spelling.
This leads me to:
It gets on my nerves when I read documentation, like:

It distracts me while reading. There are a lot of links which were probably all added because of autolinking. But I still feel the need to check whether they really are. It could be that some of them were added intentionally, linking to something else.
That’s why it sometimes disturbs my reading flow. But this could be solved by limiting the number of times a watched word is linked or restricting auto-linking to e.g. “data explorer plugin”.

9 Likes

I have a similar feedback as Moin.

Super useful. It saves a lot of time and energy.

There are, for sure, edgy cases where the same word is auto-linked too many times in guides.
Possible suggestions:

  • Limit the number of times the word is linked – at least once per paragraph or ideally once per section if feasible).
  • Exclude self-auto-linking in the topic that the link is referring to.
  • Exclude auto-linking in headings
  • If it still doesn’t help for some guide, we can see how to improve the text.

Overall, it’s really good and convenient. I would be careful about what words to add, though. [1]


About what to add, let’s see,

  • A few reference guides for users, moderators, admins, and developers (and potentially the index ones; maybe it’s too early for that, though).

I wonder what the statistics are. Based on how often a link is referred to, it could be a good idea to add a keyword for that link. :thinking:


  1. For example, trust level would be likely overwhelming without any control. ↩︎

6 Likes

Yep,

I agree, however, we should limit auto-linking in posts. If I write Data Explorer 5 times in a single post, I don’t need 5 links in that post. Only the first instance should be linked, and the others ignored.

4 Likes

I think the additional links in the index topics are very confusing

Plus repeating same thing looks… odd.

Those index topics are the base for the doc sidebar indexes themselves so the formatting is what helps makes the magic happen (display title: link). :magic_wand:

Though I think there’s a case for unlisting the index topics now we have the actual sidebars in place and making them more a background thing.

I know that. And yet it looks odd. And in some cases a row will be so long that there isn’t enough room to show all the text — or that was situation earlier when I tested it on my forum [1]


  1. and that is one reason, with a lot of manual work, why it is on hold and I’m trying to figure out do I need that option; but that is only my headache, but layout issues are not :smirk: ↩︎

I think the short titles are definitely important to get right as the space is limited for them. Bert did the first pass, but I do plan on having a second go to smooth out any weird ones.

For the auto-linking, I’m not sure if one of the usual tricks of breaking up the watched word with <guff> would work for these ones. I think hiding the base index topic would be less of a faff. :thinking:

1 Like