Skip to content

Conversation

@chrisdavidmills
Copy link
Contributor

Description

I decided to update the Basic HTML syntax learning area article to improve the wording and make it more friendly to beginners, for example:

  • Making some of the examples a bit simpler, and others a bit more explanatory.
  • Removing some content that isn't helpful to beginners. For example, mentioning valid XML when talking about closing slashes, and including a discussion on the innerHTML JavaScript property when talking about whitespace. These are way out of scope for the current article and will just confuse beginners. MDN prides itself on its completeness, but a different approach is needed for the Learn area.
  • Cutting down on verbiage and simplifying explanations.
  • Using modern live sample syntax, which in a couple of cases was used to fix broken rendering.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner January 30, 2026 12:36
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team January 30, 2026 12:36
@github-actions github-actions bot added Content:Learn Learning area docs Content:Glossary Glossary entries size/m [PR only] 51-500 LoC changed labels Jan 30, 2026
@github-actions
Copy link
Contributor

Preview URLs (2 pages)

Flaws (1)

Note! 1 document with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Learn_web_development/Core/Structuring_content/Basic_HTML_syntax
Title: Basic HTML syntax
Flaw count: 1

  • macros:
    • Macro ? produces link /en-US/curriculum/ which doesn't resolve
External URLs (1)

URL: /en-US/docs/Learn_web_development/Core/Structuring_content/Basic_HTML_syntax
Title: Basic HTML syntax

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Glossary Glossary entries Content:Learn Learning area docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant