`<code>` in docblocks should use "overflow-wrap" CSS rule

[GuillaumeGomez]

Otherwise, if too long we can't read them:

With word-wrap rule:

[nox]

You probs want overflow-wrap: break-word so that it tries to not wrap mid-word (but still does if it can't do otherwise).

[GuillaumeGomez]

With your suggestion it gives:

It's weird but in a different way haha.

[the8472]

We can tell the browser where to break words by inserting <wbr> in the right places. E.g. Refresh<wbr>Kind. Together with some other CSS properties that should give us full control where it'll do the breaking.

[jsha]

@nox it's not clear to me that break-word makes wrapping word-aware (that would be quite a task!)

https://developer.mozilla.org/en-US/docs/Web/CSS/overflow-wrap

anywhere
To prevent overflow, an otherwise unbreakable string of characters — like a long word or URL — may be broken at any point if there are no otherwise-acceptable break points in the line. No hyphenation character is inserted at the break point. Soft wrap opportunities introduced by the word break are considered when calculating min-content intrinsic sizes.

break-word
The same as the anywhere value, with normally unbreakable words allowed to be broken at arbitrary points if there are no otherwise acceptable break points in the line, but soft wrap opportunities introduced by the word break are NOT considered when calculating min-content intrinsic sizes.

In other words, overflow-wrap: anywhere vs overflow-wrap: break-word differ only in whether the wrap affects min-content:

The min-content sizing keyword represents the intrinsic minimum width of the content.
For text content this means that the content will take all soft-wrapping opportunities, becoming as small as the longest word.

Emphasis mine.

We don't explicitly use min-content in our CSS as far as I can tell, but looking at the screenshots @GuillaumeGomez shared, perhaps it is introduced somewhere by browser intrinsics?

Long story short, I think we should use overflow-wrap: anywhere. It produces nicer results in these screenshots, and break-word isn't documented to provide benefits that we care about.

[nox]

@jsha I'm certainly not a CSS expert, I just meant "let's not break idents in the middle" and assumed break-word would be enough for that. It seems like @the8472 gave the proper answer for breaking correctly around :: instead of in the middle of the words.