All committers have signed the CLA.

Hi @rossmc, thanks for adding more info to the topic. On first glance, your change to the content's order helps, but it still feels like the topic is missing information that would make it easier to understand. I'll take a look at this over the next few days. Thanks, again.

@bdenham yes I agree it can probably improved further. But I think the current doc is missing out on something very important by not mentioning .media-width() mixins and the @media-common style group. I've spoken with quite a few devs who have gotten stuck on this when first working with M2.

There is more info on it in the Magento UI library documentation
/pub/static/frontend/Magento/blank/en_US/css/docs/responsive.html

Let me know if there is anyway I can help, to rewrite a section or something.

Thanks, @rossmc. Yes, I completely agree with you on the importance of documenting the .media-width() mixins and the @media-common style group and will devote time early next week to work with you to get this merged into production. Thanks again for helping out with this!

Any update on this @bdenham, let me know if I can amend in some way to help

Hey @rossmc, so sorry I had to put this on the back burner for a bit, but I will commit to working with you to complete this before the end of this week! Stay tuned.