Remove or refactor duplicate content in HTML artices in Learn area

[dipikabh]

MDN URL

https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics

What specific section or headline is this issue about?

https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics#anatomy_of_an_html_element

What information was incorrect, unhelpful, or incomplete?

This issue has been raised in https://github.com/orgs/mdn/discussions/658.

Some of the sections and content across these two pages is duplicate or very similar: https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started

For example:

• https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics#anatomy_of_an_html_element and https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started#anatomy_of_an_html_element
• https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics#nesting_elements and https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started#nesting_elements

What did you expect to see?

Content that is not dupliacte

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

No response

Do you have anything more you want to share?

No response

[awxiaoxian2020]

Any experts want to put forward for this? ping politely @bsmth and @wbamberg to get some good ideas :)

[wbamberg]

I'm not sure what's best here, and wonder what @chrisdavidmills thinks. Yes, a fair amount of https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics#so_what_is_html is duplicated from https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started, although there are more or less editorial divergences.

And yes, duplication in general is not great. But these pages serve different audiences.

• "Getting started with the web" is a crash course in the absolute basics of front-end, including HTML, CSS, JS, and tooling.
• "Getting started with HTML" is the first chapter in a more elaborate and advanced HTML course.

Both chapters need to talk about, for instance, the anatomy of an HTML element, but they don't at all share the same flow, so trying to de-dupe the content is likely to make the content less useful for people following one or the other course.

So I'm inclined to think that the duplication is the best option at the moment, and we should close this issue..

[awxiaoxian2020]

I agree that they don't at all share the same flow. if we de-dupe the content, we need more efforts. But I think we should design a new pattern or mode or structure for these content. It just give readers a good experience :)

[Josh-Cena]

I also agree that very little can be done. Realistically speaking it's a small duplication. And it just serves as a natural segue into talking about other things like attributes and elements. If you replace either occurrence with "See the other page for an anatomy of the element", you will just make everything else appear out of context.

[awxiaoxian2020]

My vision is to completely restructure these contents rather than just doing some simple removals to provide beginners with a good experience. The beginners around me are all confused about why the previously introduced content appears again. At the very least, we need an explanation to introduce the relationships between these contents.