doc: add 'not recommended' blockquotes
Fixes: #52743
This PR adds the ability to add a warning blockquote via the following syntax:
> Warning: ...
Which will be rendered as:
Review requested:
- [ ] @nodejs/crypto
- [ ] @nodejs/nodejs-website
- [ ] @nodejs/web-infra
While I'm fine with the idea, the white text on the red background is difficult for my eyes to read.
While I'm fine with the idea, the white text on the red background is difficult for my eyes to read.
Good to note! What color scheme would you recommend?
I honestly don't know what to recommend :-/ ...
I honestly don't know what to recommend :-/ ...
I'll experiment. Right now it's the same as Stability: 1 blockquotes.
A border is also possible:
That's a LOT more readable to my eyes.
(Request Review) @nodejs/documentation
I assume I'm a bit out of the loop here, but why are we not sticking with existing concepts such as
<strong class="critical">and maybe restyle that a bit? And if you really want to introduce a custom syntax for blockquotes, why not adopt GitHub's mechanism?
I decided to go with the same syntax that the Stability: ... blockquote use. Instead of using the default critical error (because they can be [a] hard to read, and [b] these aren't critical), I went with a red box.
True, your right that the the redesign will incorporate a lot of changes, so I'll close this, but I recommend something similar be included in the redesign
True, your right that the the redesign will incorporate a lot of changes, so I'll close this, but I recommend something similar be included in the redesign
Feel free to go over the Figmas and check if we have something similar like this already, otherwise, feel free to make suggestions :)
True, your right that the the redesign will incorporate a lot of changes, so I'll close this, but I recommend something similar be included in the redesign
Feel free to go over the Figmas and check if we have something similar like this already, otherwise, feel free to make suggestions :)
Oh! I didn't know we had figmas, I'll take a look!