Check out this page: https://developer.mozilla.org/en-US/docs/Web/CSS/margin-bloc...
> The `margin-block` CSS shorthand property defines the logical block start and end margins of an element, which maps to physical margins depending on the element's writing mode, directionality, and text orientation.
Whew, that's a lot.
Setting aside how inside baseball the terms "logical block" and "physical margin" are, this description fails to tell the reader why they would want to use this property. Why use this, instead of `margin`? It's nowhere on the page. Typically, that reasoning lays buried in the distant and forbidden "Guides" section (which MDN's search doesn't index).
To find our reasoning, you must go to Guides, under CSS expand "CSS building blocks," then finally click "Handling different text directions": https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_...
“But look, you found the explanation for `margin-block`, didn’t you?”
“Yes I did. It was on display in the bottom of a locked filing cabinet stuck in a disused lavatory with a sign on the door saying 'Beware of the Leopard.'”
> how to find the guides
I'll let you know when I learn how to find the guides. I didn't even know that one existed until I scoured the site.
What you won't find are general details on the more specific references. Unfortunately, search engines prefer the specific ones, so you will have to backtrack by yourself.
https://developer.mozilla.org/en-US/docs/Learn/Getting_start...
I only need MDN when I want to read stuff 'deep', but 98% of the time I don't need that depth.
MDN is also hard to navigate, it works like a thick dictionary to me, it will be needed, but only rarely.