Add skip_code_autolink_to option

[viniciusmuller]

Adds a new option :skip_code_autolink_to that given a list of strings, skips term autolinking if it matches one of the strings.

I think Enum.any?/2 will do fine, but if needed we can convert the list of strings given by the user to a MapSet and use it internally as well.

Closes #1750

[whatyouhide]

Should we allow regexes here as well?

[josevalim]

We can add if necessary later on? Unless you have an immediate need for it?

[whatyouhide]

I deprecated a module, so I'd like to do ~r/MyMod(\..*)?/ basically instead of having to list the references to the module alone and then to all the functions I mention. Unless I'm reading the feature wrong 😉

[wojtekmach]

not sure if this would ever come up but the above regex will also catch MyNamespace.MyMod. So maybe it should be: ~r/^MyMod(\..*)?/. but then we'd still warn on callbacks and types so I suppose ~r/^([bt]:)?MyMod(\..*)?/.

I think we can add the regex support but it needs to be used carefully. but yeah I'd rather have users spell out things explicitly to keep the code explicit too. how annoying is this gonna be for you? is this for a changelog? If so consider just cutting off old changelog entries, e.g. write:

The CHANGELOG for v1.15 and previous releases can be found [in the v1.15] branch

or something like that.

[josevalim]

Maybe we just make it a function and allow you to pass anything?

[wojtekmach]

Nice, +1 from me.

[josevalim]

I will merge this and we can make both skip_ options accept a function too.

[wojtekmach]

The PR looks good to me.

I'm not even sorry for sounding like a broken radio, we really need to opt-in to auto linking by writing [`Foo.bar`] (#1663), not opt-out.

@whatyouhide fyi: I do the above explicitly in my extras. It is annoying to type because I have to maintain links manually, e.g. in my README.md I have:

* Follows redirects (via [`redirect`] step.)

(...)

[`redirect`]: https://hexdocs.pm/req/Req.Steps.html#redirect/1

on the flip side, my not-so-auto links work on both https://hexdocs.pm/req/readme.html AND https://github.com/wojtekmach/req/blob/main/README.md.

so if you'd adopt it, the need for this PR disappears. But ngl, it's annoying to manually keep them, so +1 for the PR.

[josevalim]

💚 💙 💜 💛 ❤️