Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fill out the how the web works learn content #38109

Merged

Conversation

chrisdavidmills
Copy link
Contributor

Description

The main aim of this PR is to fill out the incomplete content in the How browsers load websites article.

I have also:

  • Removed the content in the What is CSS? article that basically does the same job as "How browsers load websites" is meant to do, using it in that article instead and replacing it with a much briefer summary and a rendering example.
  • Removed the "How web pages are rendered" content in the Browsing the web article, to get rid of more repetition.
  • Updated The web standards model so that it provides a better description of server-side languages and how they relate to web standards, and also defines static and dynamic languages.
  • Updated the Basic HTML syntax article to make it clear what the relationship is between HTML documents and web pages.
  • Updated How the web works to include the missing sections on HTTP and URLs, plus a few other updates.
  • A few more small changes.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner February 11, 2025 14:26
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team February 11, 2025 14:26
@github-actions github-actions bot added Content:Learn Learning area docs size/m [PR only] 51-500 LoC changed labels Feb 11, 2025
Copy link
Contributor

github-actions bot commented Feb 11, 2025

Preview URLs (6 pages)
Flaws (13)

Note! 3 documents with no flaws that don't need to be listed. 🎉

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

  • broken_links:
    • /en-US/docs/Glossary/void_element is ill cased
    • /en-US/docs/Glossary/character_reference is ill cased
    • /en-US/docs/Glossary/character_reference is ill cased
  • macros:
    • Macro produces link /en-US/docs/Glossary/void_element which is a redirect
    • Macro produces link /en-US/docs/Glossary/character_reference which is a redirect
    • Macro produces link /en-US/docs/Glossary/character_reference which is a redirect

URL: /en-US/docs/Learn_web_development/Core/Styling_basics/What_is_CSS
Title: What is CSS?
Flaw count: 6

  • broken_links:
    • /en-US/docs/Glossary/browser is ill cased
    • /en-US/docs/Web/HTML/Element/heading_elements is ill cased
    • /en-US/docs/Glossary/property/CSS is ill cased
  • macros:
    • Macro produces link /en-US/docs/Glossary/browser which is a redirect
    • Macro produces link /en-US/docs/Web/HTML/Element/heading_elements which is a redirect
    • Macro produces link /en-US/docs/Glossary/property/CSS which is a redirect

URL: /en-US/docs/Learn_web_development/Getting_started/Web_standards/How_the_web_works
Title: How the web works
Flaw count: 1

  • macros:
    • Macro produces link /en-US/docs/Learn_web_development/Getting_started/Web_standards/The_Web_standards_model which is a redirect
External URLs (3)

URL: /en-US/docs/Learn_web_development/Getting_started/Web_standards/How_the_web_works
Title: How the web works

(comment last updated: 2025-02-12 18:55:40)

@bsmth
Copy link
Member

bsmth commented Feb 12, 2025

Thanks, Chris, looking good! Couple of comments for you to consider! 🙏🏻

chrisdavidmills and others added 16 commits February 12, 2025 17:24
…css/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…css/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_browsers_load_websites/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_browsers_load_websites/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/the_web_standards_model/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_browsers_load_websites/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_browsers_load_websites/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_browsers_load_websites/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
…s/how_the_web_works/index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great, thanks, Chris! 👍🏻

@chrisdavidmills
Copy link
Contributor Author

great, thanks, Chris! 👍🏻

@bsmth yay, cheers for the awesome review!

@chrisdavidmills chrisdavidmills merged commit 90e419a into mdn:main Feb 13, 2025
8 checks passed
@chrisdavidmills chrisdavidmills deleted the update-how-the-web-works-content branch February 13, 2025 08:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
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.

2 participants