News for hackers. Stuff that matters.
Re:W3.css – A minimal alternative to Bootstrap by lelandfe on Tuesday September 13, 2022 @10:11PM (#32832507)
As someone who helps beginners learn CSS regularly at my job, my biggest qualm with MDN is that they tend to leave out the why.

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.'”

Re:W3.css – A minimal alternative to Bootstrap by blakblakarak on Wednesday September 14, 2022 @02:59AM (#32834096)
This is a good resource for beginner too: https://tympanus.net/codrops/css_reference/
Re:W3.css – A minimal alternative to Bootstrap by marcosdumay on Wednesday September 14, 2022 @11:09AM (#32838331)
You can't expect long documentation for beginners to be inline on the reference pages. Just start teaching the beginners you help how to find the guides.
Re:W3.css – A minimal alternative to Bootstrap by lelandfe on Wednesday September 14, 2022 @11:50AM (#32838886)
The guides are written for beginners. But an explanation of why does not need to be. It could even be included in that intro paragraph with just a sentence or two, with a link out to the guide for more.

> 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.

Re:W3.css – A minimal alternative to Bootstrap by marcosdumay on Wednesday September 14, 2022 @11:58AM (#32839032)
There are a lot of guides. If you go to the more general references on the hierarchy (indexed at the left side), you will find small explanations on the why with links for the guides.

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.