Re:MDN Blog
by itsuka on Tuesday May 30, 2023 @12:09PM
(#36126557)
You're right. I am not as familiar with MDN's organization and CSS as you are (I only recently discovered that CSS is a typed language). However, I find it confusing that some pages have their own page for values, while others don't. As a reference page, I expect the valid syntax for all values to be provided. But I agree that specific examples can be linked to other resources.
[ Parent
| on HN ]
Re:MDN Blog
by chrismorgan on Tuesday May 30, 2023 @12:22PM
(#36126731)
Things like colours and units get used in many properties (color, background-color, border-color, box-shadow—in which <color> is only a part of the syntax—and many more; width, length, font-size, font—a shorthand in which <length> is only a part—and many more), and if they get expanded in one place, then all properties that use them take the new definition—hence <color>, <length>, &c. as the only sensible way to structure things (in spec, reference and mental model). By contrast, the values of properties like ‘display’ aren’t used anywhere else.
It sounds like a large part of the problem is helping to build the right mental model. If you understand that colours and lengths are used in many places, it will make sense that they will be documented separately from the properties, and that the properties’ references will just refer to them.