3 ms·
This can be a GOTCHA in docs site UX. A lot of docs sites use admonitions (e.g. [1]) to call special attention to a particular piece of info and, ironically, th
by kaycebasques 3y ago
This can be a GOTCHA in docs site UX. A lot of docs sites use admonitions (e.g. [1]) to call special attention to a particular piece of info and, ironically, the admonition might make readers less likely to see the info.
[1] https://docusaurus.io/docs/markdown-features/admonitions https://docusaurus.io/docs/markdown-features/admonitions
- hinkley 3y agoI ran into this about 8 years ago. I was using a new dev tool, and the docs said there was a UI element to do something. I looked, and looked and just could find what they were talking about. So I contacted them to ask what the deal was, and they sent me a screen grab. Turns out what I was looking for was in a weird rectangle embedded halfway down the page and centered on the 3rd quartile of the width of the page. Exactly where someone would stick an ad into an HTML page. They had put a box around it and styled it a little differently, so my brain tuned it right out.