change double backtick to single backtick do take advantage of default role?

Should we change the double backticks to single backticks in the docs to make use of the new default role (#11186). That way we get more links to the glossary. Do we want to link to the glossary at every mention of fit?

[jorisvandenbossche]

I think we should be able to suppress those warnings in doc/conf.py, at least that’s what I’m doing in #12654 for some matplotlib warnings.

That’s an actual matplotlib ‘python’ warning, while here we are speaking about sphinx ‘log’ warnings. So I don’t think it can be done in the same way?

Perhaps http://www.sphinx-doc.org/en/master/usage/configuration.html#confval-suppress_warnings or maybe it’s too general

I didn’t try, but it seems to general. Because we would only want to suppress warnings if it came from this default :any: role, we still want to see warnings if we made a type in an explicit :ref:.. or :term:.. ?

Personally, I would only use single backticks if we explicitly want it to link to something (and using single backticks instead of the actual :role:`..` to make it shorter, more readable in plain text, …), and still use double backticks if we know that the content won’t references anything and simply want to render it as code.

[amueller]

apart from breaking all PRs 😉