mdn / content

The content behind MDN Web Docs
https://developer.mozilla.org
Other
9.18k stars 22.47k forks source link

Lack of links to documents for download #36568

Open xiaolinggnb opened 2 hours ago

xiaolinggnb commented 2 hours ago

MDN URL

https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Grids

What specific section or headline is this issue about?

Nesting grids and subgrid

What information was incorrect, unhelpful, or incomplete?

The chapter does not provide the corresponding file download links and see it live section, 2 examples are not, which is a bit incongruous with the previous, although clicking on the sample code of the play can be found in the source code, I do not know whether there is an omission

What did you expect to see?

It is recommended to add the file download link and see it live content, in line with the previous documentation.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

MDN metadata

Page report details * Folder: `en-us/learn/css/css_layout/grids` * MDN URL: https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Grids * GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/learn/css/css_layout/grids/index.md * Last commit: https://github.com/mdn/content/commit/44b18841ff739fbf1a5450805d85f839fa3e68a5 * Document last modified: 2024-07-25T20:16:09.000Z
xiaolinggnb commented 2 hours ago

Like these 2 files, I copied the code from the Doc's play area, but not saw them on the github repo. Grids.zip

bsmth commented 42 minutes ago

Hi there, thanks for reporting. I think that's my fault, where I added the 'nesting' section in https://github.com/mdn/content/pull/28983, but I did not add the code to the learning area repository. Some context for this; you can hide some example code blocks on documentation pages like this:

```css
/* important for the context */
<!-- I don't want to show or repeat this -->

{{CSS & hidden HTML combined}}



If the reader wanted to see all code that makes the example work, they could view it in a GitHub repo which contained everything. 

[Since 2023, you can break out all live samples](https://developer.mozilla.org/en-US/blog/introducing-the-mdn-playground/) into the Playground, which has all code used to make the example work, including any code that is hidden on the documentation page ([like these blocks](https://github.com/bsmth/content/blob/1f8e00821b6a18996dd58f32c7adedfe8902bdae/files/en-us/learn/css/css_layout/grids/index.md?plain=1#L74-L103)). 

So this is an authoring issue, we could mention opening the playground to see the full source instead of pointing to source on GitHub, but it would be good to be consistent on that. In general, we're [trying to avoid maintaining copies of example code](https://github.com/mdn/mdn/issues/597) in multiple places now, so I don't think adding it to the learning area repo is in line with that.

Does that make sense?