doc: make types in API docs not blend visually with description

[thorn0]

Let's make types look differently from the rest of the text at least somehow (color, italic, whatever).

That's what it looks like without this change:

[Trott]

I have no opinion on the aesthetics or the need, but the particular color choice here results in insufficient contrast for accessibility purposes. #00b192 on a white background has insufficient contrast to pass WCAG AA or WCAG AAA. The original value of #222 passes both AA and AAA on the other hand. Maybe try something closer to #005546 which will also pass AA and AAA.

[thorn0]

The thing is the contrast is needed not only with the background, but also with the normal text. If I change it to #005546, it blends again, at least to my eye. BTW, the color of the links in those docs is #ffa158, which doesn't pass AA and AAA as well.

[silverwind]

How about something a bit more funky?

(This highlights things not correctly classified as type, like Boolean above)

span.type {
    color: #FFF;
    background: #7AAB13;
    font-size: .7em;
    padding: 0 .2em;
    border-radius: 2px;
    position: relative;
    top: -.15em;
}

[jasnell]

@nodejs/documentation

[brendanashworth]

Ref'ing to (issue) #4350 and (PR) #4378, the latter instead making these types link to MDN. This and #4378 are alternatives to eachother.

[claudiorodriguez]

Please note that the point of #4741 (had to remake the PR) is to generate the links, the styling is incidental but the PRs will conflict with each other. I'd suggest waiting until #4741 is merged, then focusing on the styling on a new PR

[silverwind]

47e926a has landed, making this PR obsolete. Thanks @fansworld-claudio!