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

Draft PR for merging MDN Curriculum into Learning Area #36502

Closed
Show file tree
Hide file tree
Changes from 33 commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
3398068
fix links
chrisdavidmills Oct 25, 2024
4a27d20
fix merge conflict
chrisdavidmills Oct 27, 2024
7201344
Finish the getting started module structures
chrisdavidmills Oct 28, 2024
8ee01ac
more changes
chrisdavidmills Oct 30, 2024
405b8e7
Merge branch 'main' into merge-curriculum-into-learning-area
chrisdavidmills Nov 4, 2024
86adf94
finish structuring content module
chrisdavidmills Nov 6, 2024
dd52f2b
Update files/en-us/learn_web_development/core/structuring_content/htm…
chrisdavidmills Nov 6, 2024
22bcd46
Update files/en-us/learn_web_development/core/structuring_content/htm…
chrisdavidmills Nov 6, 2024
b088ac4
Update files/en-us/learn_web_development/core/structuring_content/htm…
chrisdavidmills Nov 6, 2024
d87d2b5
Update files/en-us/learn_web_development/core/structuring_content/ind…
chrisdavidmills Nov 6, 2024
dc28ce3
Update files/en-us/learn_web_development/core/structuring_content/moz…
chrisdavidmills Nov 6, 2024
fae494f
fix typo
chrisdavidmills Nov 6, 2024
d3e4012
Merge branch 'main' into merge-curriculum-into-learning-area
chrisdavidmills Nov 6, 2024
7b9dab7
Merge branch 'main' into merge-curriculum-into-learning-area
chrisdavidmills Nov 7, 2024
8c145e3
Merge branch 'main' into merge-curriculum-into-learning-area
chrisdavidmills Nov 7, 2024
8e4b8bf
fix broken links
chrisdavidmills Nov 7, 2024
17aeaca
Update files/en-us/learn_web_development/core/structuring_content/htm…
chrisdavidmills Nov 7, 2024
a3b67c5
Update files/en-us/learn_web_development/core/structuring_content/cre…
chrisdavidmills Nov 7, 2024
48acf0d
Update files/en-us/learn_web_development/core/structuring_content/adv…
chrisdavidmills Nov 7, 2024
533d221
fix broken link and uncomment sidebar macros
chrisdavidmills Nov 7, 2024
f1f282d
Merge branch 'merge-curriculum-into-learning-area' of github.com:chri…
chrisdavidmills Nov 7, 2024
ef6ded5
Update links to moved pages
chrisdavidmills Nov 7, 2024
1c92f0e
Move HTML Howto and update links
chrisdavidmills Nov 7, 2024
0e8b324
Merge branch 'main' into merge-curriculum-into-learning-area
chrisdavidmills Nov 8, 2024
6e89117
Partial work towards first CSS module
chrisdavidmills Nov 8, 2024
9ee8c04
Merge branch 'merge-curriculum-into-learning-area' of github.com:chri…
chrisdavidmills Nov 8, 2024
fe40d88
Complete work on first CSS module
chrisdavidmills Nov 12, 2024
100b945
Update files/en-us/learn_web_development/core/styling_basics/getting_…
chrisdavidmills Nov 12, 2024
9b9568e
Update files/en-us/learn_web_development/core/styling_basics/getting_…
chrisdavidmills Nov 12, 2024
060ba53
Update files/en-us/learn_web_development/core/styling_basics/basic_se…
chrisdavidmills Nov 12, 2024
cfd81d5
Merge branch 'main' of github.com:mdn/content into merge-curriculum-i…
chrisdavidmills Nov 12, 2024
47ecfd6
Complete work on Text styling module
chrisdavidmills Nov 12, 2024
9091e88
Complete work on CSS modules, start JS module
chrisdavidmills Nov 13, 2024
9703399
Finish JS module and do Frameworks module
chrisdavidmills Nov 15, 2024
177e376
Accessibility, design, and VCS modules
chrisdavidmills Nov 15, 2024
3efaea5
Starting work on extensions
chrisdavidmills Nov 15, 2024
5e2f93f
animation and objects learning extensions
chrisdavidmills Nov 18, 2024
48e8193
Update files/en-us/learn_web_development/core/design_for_developers/i…
chrisdavidmills Nov 18, 2024
b4eb709
Update files/en-us/learn_web_development/core/design_for_developers/i…
chrisdavidmills Nov 18, 2024
0ddc803
Update files/en-us/learn_web_development/core/design_for_developers/i…
chrisdavidmills Nov 18, 2024
99de5cb
Update files/en-us/learn_web_development/core/accessibility/tooling/i…
chrisdavidmills Nov 18, 2024
6d8aa1e
Update files/en-us/learn_web_development/core/accessibility/index.md
chrisdavidmills Nov 18, 2024
0e57011
Client-side APIs learning extension
chrisdavidmills Nov 18, 2024
56d4065
Asyn JS learning extension
chrisdavidmills Nov 18, 2024
6ed5aec
Remove old Learn/JavaScript page, and update cross-links
chrisdavidmills Nov 18, 2024
616330e
Performance extension module
chrisdavidmills Nov 18, 2024
9cf44b0
Create security and privacy extension module stub
chrisdavidmills Nov 18, 2024
05dca3b
Testing module
chrisdavidmills Nov 18, 2024
5e0bded
Server-side extension modules
chrisdavidmills Nov 18, 2024
be7e9c2
Forms extension module
chrisdavidmills Nov 18, 2024
58e139c
Remove Property_compatibility_table_for_form_controls article
chrisdavidmills Nov 18, 2024
300e3a0
Client-side tools extension module
chrisdavidmills Nov 18, 2024
82f83be
Remove/redirect old Tools and testing landing page
chrisdavidmills Nov 18, 2024
ff0f1d6
Remove/redirect common questions sections to new howto directory
chrisdavidmills Nov 18, 2024
760d8c8
Remove/redirect old common questions landing page
chrisdavidmills Nov 18, 2024
4fe97b1
Move HTML cheatsheet to learn_web_development
chrisdavidmills Nov 18, 2024
ddac09d
Move last few HTML docs out of old Learn directory
chrisdavidmills Nov 19, 2024
ace8d44
remove/redirect old HTML learn landing pages
chrisdavidmills Nov 19, 2024
27768eb
Update links to old CSS learn landing pages
chrisdavidmills Nov 19, 2024
5b13cf3
Move MathML learning guides to Web/MathML
chrisdavidmills Nov 19, 2024
d677c36
Remove/redirect MathML learn landing page
chrisdavidmills Nov 19, 2024
6cee433
Remove/redirect top-level learn landing page
chrisdavidmills Nov 19, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
558 changes: 359 additions & 199 deletions files/en-us/_redirects.txt

Large diffs are not rendered by default.

9,028 changes: 4,458 additions & 4,570 deletions files/en-us/_wikihistory.json

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ In this step-by-step tutorial, we create a simple mobile **MDN Breakout** game w

Every step has editable, live samples available to play with, so you can see what the intermediate stages should look like. You will learn the basics of using the Phaser framework to implement fundamental game mechanics like rendering and moving images, collision detection, control mechanisms, framework-specific helper functions, animations and tweens, and winning and losing states.

To get the most out of this series of articles you should already have basic to intermediate [JavaScript](/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics) knowledge. After working through this tutorial, you should be able to build your own simple Web games with Phaser.
To get the most out of this series of articles you should already have basic to intermediate [JavaScript](/en-US/docs/Learn_web_development/Getting_started/Your_first_website/Adding_interactivity) knowledge. After working through this tutorial, you should be able to build your own simple Web games with Phaser.

![Gameplay screen from the game MDN Breakout created with Phaser where you can use your paddle to bounce the ball and destroy the brick field, with keeping the points and lives.](mdn-breakout-phaser.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ In this step-by-step tutorial we create an **MDN Breakout** game written entirel

Every step has editable, live samples available to play with so you can see what the intermediate stages should look like. You will learn the basics of using the {{htmlelement("canvas")}} element to implement fundamental game mechanics like rendering and moving images, collision detection, control mechanisms, and winning and losing states.

To get the most out of this series of articles you should already have basic to intermediate [JavaScript](/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics) knowledge. After working through this tutorial you should be able to build your own Web games.
To get the most out of this series of articles you should already have basic to intermediate [JavaScript](/en-US/docs/Learn_web_development/Getting_started/Your_first_website/Adding_interactivity) knowledge. After working through this tutorial you should be able to build your own Web games.

![Gameplay screen from the game MDN Breakout where you can use your paddle to bounce the ball and destroy the brick field, with keeping the score and lives.](mdn-breakout-gameplay.png)

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/advance_measure/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,5 @@ The _advance measure_ of unit `ch` is either the width or height of character "0
## See also

- {{cssxref("<length>")}}
- [Learn: CSS values and units](/en-US/docs/Learn/CSS/Building_blocks/Values_and_units)
- [Learn: CSS values and units](/en-US/docs/Learn_web_development/Core/Styling_basics/Values_and_units)
- [TextMetrics API](/en-US/docs/Web/API/TextMetrics)
2 changes: 1 addition & 1 deletion files/en-us/glossary/alpha/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ As you can see, the color without an alpha channel completely blocks the backgro
## See also

- [CSS colors](/en-US/docs/Web/CSS/CSS_colors)
- [CSS values and units introduction](/en-US/docs/Learn/CSS/Building_blocks/Values_and_units)
- [Learn: Values and units](/en-US/docs/Learn_web_development/Core/Styling_basics/Values_and_units)
- [Image file type and format guide](/en-US/docs/Web/Media/Formats/Image_types)
- [Alpha compositing](https://en.wikipedia.org/wiki/Alpha_compositing) on Wikipedia
- [RGBA color model](https://en.wikipedia.org/wiki/RGBA_color_model) on Wikipedia
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/css/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ p {

## See also

- [Learn CSS](/en-US/docs/Learn/CSS)
- [Learn CSS](/en-US/docs/Learn_web_development/Core/Styling_basics)
- [The CSS documentation](/en-US/docs/Web/CSS)
- [CSS](https://en.wikipedia.org/wiki/CSS) on Wikipedia
- [The CSS Working Group current work](https://www.w3.org/Style/CSS/current-work)
2 changes: 1 addition & 1 deletion files/en-us/glossary/css_selector/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ The resulting page content is styled like this:

## See also

- [Learn more about CSS selectors](/en-US/docs/Learn/CSS/Building_blocks/Selectors) in our introduction to CSS.
- [Learn more about CSS selectors](/en-US/docs/Learn_web_development/Core/Styling_basics/Basic_selectors) in our introduction to CSS.
- Basic selectors

- [Type selectors](/en-US/docs/Web/CSS/Type_selectors) `elementname`
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/element/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ Elements and {{glossary("tag", "tags")}} are _not_ the same things. Tags begin o

## See also

- [Getting started with HTML](/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started)
- [Basic HTML Syntax](/en-US/docs/Learn_web_development/Core/Structuring_content/Basic_HTML_syntax)
- [Defining custom elements](/en-US/docs/Web/API/Web_components/Using_custom_elements)
- The {{domxref("Element")}} interface, representing an element in the DOM.
2 changes: 1 addition & 1 deletion files/en-us/glossary/head/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ The **Head** is the part of an {{glossary("HTML")}} document that contains {{glo
## See also

- {{htmlelement("head")}} element reference on MDN
- [The HTML \<head>](/en-US/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML) on the MDN Learning Area
- [What's in the head? Webpage metadata](/en-US/docs/Learn_web_development/Core/Structuring_content/Webpage_metadata) on the MDN Learning Area
2 changes: 1 addition & 1 deletion files/en-us/glossary/hyperlink/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Hyperlinks connect webpages or data items to one another. In HTML, {{HTMLElement
## See also

- [Hyperlink](https://en.wikipedia.org/wiki/Hyperlink) on Wikipedia
- The [Hyperlink](/en-US/docs/Learn/HTML/Introduction_to_HTML/Creating_hyperlinks) guide on MDN
- [Creating links](/en-US/docs/Learn_web_development/Core/Structuring_content/Creating_links)
- [Links in HTML Documents - W3C](https://www.w3.org/TR/1999/REC-html401-19991224/struct/links.html)
- [HTML a - hyperlink - W3C](https://w3c.github.io/html-reference/a.html)
- [`<a>` on MDN](/en-US/docs/Web/HTML/Element/a)
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/ink_overflow/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The **ink overflow** of a box refers to the part of the box and its contents tha

Ink overflow is the overflow of painting effects such as [box shadows](/en-US/docs/Web/CSS/box-shadow), [border images](/en-US/docs/Web/CSS/CSS_backgrounds_and_borders), [text decoration](/en-US/docs/Web/CSS/CSS_text_decoration), [outlines](/en-US/docs/Web/CSS/outline), etc. that do not affect layout or otherwise extend the scrollable overflow area. Ink overflow is also the overhanging of glyphs, such as ascenders and descenders extending outside the em box.

As [replaced elements](/en-US/docs/Web/CSS/Replaced_element) always establish an independent [formatting context](/en-US/docs/Web/CSS/CSS_flow_layout/Introduction_to_formatting_contexts), any overflow of replaced content is always ink overflow (as opposed to [scrollable overflow](/en-US/docs/Learn/CSS/Building_blocks/Overflowing_content)).
As [replaced elements](/en-US/docs/Web/CSS/Replaced_element) always establish an independent [formatting context](/en-US/docs/Web/CSS/CSS_flow_layout/Introduction_to_formatting_contexts), any overflow of replaced content is always ink overflow (as opposed to [scrollable overflow](/en-US/docs/Learn_web_development/Core/Styling_basics/Overflow)).

## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/intrinsic_size/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ page-type: glossary-definition

{{GlossarySidebar}}

In CSS, the _intrinsic size_ of an element is the size it would be based purely on its content without taking into account the effects of the context it appears in. For example, the sizing applied by CSS [box model](/en-US/docs/Learn/CSS/Building_blocks/The_box_model) properties. An element's intrinsic sizes are represented by its {{cssxref("min-content")}} and {{cssxref("max-content")}} sizes.
In CSS, the _intrinsic size_ of an element is the size it would be based purely on its content without taking into account the effects of the context it appears in. For example, the sizing applied by CSS [box model](/en-US/docs/Learn_web_development/Core/Styling_basics/Box_model) properties. An element's intrinsic sizes are represented by its {{cssxref("min-content")}} and {{cssxref("max-content")}} sizes.

Inline elements are sized intrinsically: [sizing](/en-US/docs/Web/CSS/CSS_box_sizing) and [box](/en-US/docs/Web/CSS/CSS_box_model) properties including {{cssxref("height")}}, {{cssxref("width")}}, {{cssxref("block-size")}}, {{cssxref("inline-size")}}, and {{cssxref("padding-block")}} and {{cssxref("margin-block")}} have no impact on them ( though {{cssxref("margin-inline")}} and {{cssxref("padding-inline")}} do).

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/media/css/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ CSS offers several features that allow you to tweak your document's styles—or

- [Using media queries](/en-US/docs/Web/CSS/CSS_media_queries/Using_media_queries)
- [Media queries](/en-US/docs/Web/CSS/CSS_media_queries)
- {{cssxref("@media")}} [at-rule](/en-US/docs/Web/CSS/At-rule): Conditionally apply part of a [stylesheet](/en-US/docs/Learn/CSS/First_steps/How_CSS_works#applying_css_to_the_dom), based on the result of a media query.
- {{cssxref("@media")}} [at-rule](/en-US/docs/Web/CSS/At-rule): Conditionally apply part of a CSS stylesheet, based on the result of a media query.
- {{domxref("Window.matchMedia()")}}: Test the viewing device against a media query
2 changes: 1 addition & 1 deletion files/en-us/glossary/metadata/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ page-type: glossary-definition

## See also

- [Learn: metadata](/en-US/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML#metadata_the_meta_element)
- [Learn: metadata](/en-US/docs/Learn_web_development/Core/Structuring_content/Webpage_metadata#metadata_the_meta_element)
- [metadata](https://en.wikipedia.org/wiki/Metadata) on Wikipedia
- The {{htmlelement("meta")}} element on MDN
2 changes: 1 addition & 1 deletion files/en-us/glossary/property/css/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,6 @@ div {

## See also

- [Learn CSS](/en-US/docs/Learn/CSS)
- [Learn CSS](/en-US/docs/Learn_web_development/Core/Styling_basics)
- [The CSS reference on MDN](/en-US/docs/Web/CSS/Reference)
- [The CSS Working Group current work](https://www.w3.org/Style/CSS/current-work)
2 changes: 1 addition & 1 deletion files/en-us/glossary/scroll_container/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ The scrollport is the visible part of a scroll container and coincides with the

## See also

- [CSS building blocks: overflowing content](/en-US/docs/Learn/CSS/Building_blocks/Overflowing_content)
- [Learn: Overflowing content](/en-US/docs/Learn_web_development/Core/Styling_basics/Overflow)
- [Scroll snapping](/en-US/docs/Glossary/Scroll_snap), including [scroll snap container](/en-US/docs/Glossary/Scroll_snap#scroll_snap_container)
- [CSS overflow](/en-US/docs/Web/CSS/CSS_overflow) module
- [CSS overscroll behavior](/en-US/docs/Web/CSS/CSS_overscroll_behavior) module
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/stylesheet/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,5 @@ External stylesheets are generally preferred because they allow you to control t

## See also

- [CSS first steps](/en-US/docs/Learn/CSS/First_steps)
- [CSS Styling basics](/en-US/docs/Learn_web_development/Core/Styling_basics)
- Stylesheets on [Wikipedia](<https://en.wikipedia.org/wiki/Style_sheet_(web_development)>)
8 changes: 4 additions & 4 deletions files/en-us/learn/accessibility/css_and_javascript/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@
- Make sure your headings stand out from your body text, typically big and bold like the default styling. Your lists should look like lists.
- Your text color should contrast well with your background color.

See [HTML text fundamentals](/en-US/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals) and [Styling text](/en-US/docs/Learn/CSS/Styling_text) for more information.
See [Headings and paragraphs in HTML](/en-US/docs/Learn_web_development/Core/Structuring_content/Headings_and_paragraphs) and [Styling text](/en-US/docs/Learn/CSS/Styling_text) for more information.

Check failure on line 84 in files/en-us/learn/accessibility/css_and_javascript/index.md

View workflow job for this annotation

GitHub Actions / check_url_issues

Slug 'learn/css/styling_text' has been deleted

#### Emphasized text

Expand All @@ -104,7 +104,7 @@
}
```

You will however rarely need to style emphasis elements in any significant way. The standard conventions of bold and italic text are very recognizable, and changing the style can cause confusion. For more on emphasis, see [Emphasis and importance](/en-US/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#emphasis_and_importance).
You will however rarely need to style emphasis elements in any significant way. The standard conventions of bold and italic text are very recognizable, and changing the style can cause confusion. For more on emphasis, see [Emphasis and importance](/en-US/docs/Learn_web_development/Core/Structuring_content/Emphasis_and_importance).

#### Abbreviations

Expand All @@ -125,7 +125,7 @@
}
```

The recognized styling convention for abbreviations is a dotted underline, and it is unwise to significantly deviate from this. For more on abbreviations, see [Abbreviations](/en-US/docs/Learn/HTML/Introduction_to_HTML/Advanced_text_formatting#abbreviations).
The recognized styling convention for abbreviations is a dotted underline, and it is unwise to significantly deviate from this. For more on abbreviations, see [Abbreviations](/en-US/docs/Learn_web_development/Core/Structuring_content/Advanced_text_features#abbreviations).

#### Links

Expand Down Expand Up @@ -201,7 +201,7 @@

### Hiding things

There are many instances where a visual design will require that not all content is shown at once. For example, in our [Tabbed info box example](https://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/tabbed-info-box.html) (see [source code](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/tabbed-info-box.html)) we have three panels of information, but we are [positioning](/en-US/docs/Learn/CSS/CSS_layout/Positioning) them on top of one another and providing tabs that can be clicked to show each one (it is also keyboard accessible — you can alternatively use Tab and Enter/Return to select them).
There are many instances where a visual design will require that not all content is shown at once. For example, in our [Tabbed info box example](https://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/tabbed-info-box.html) (see [source code](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/tabbed-info-box.html)) we have three panels of information, but we are [positioning](/en-US/docs/Learn_web_development/Core/CSS_layout/Positioning) them on top of one another and providing tabs that can be clicked to show each one (it is also keyboard accessible — you can alternatively use Tab and Enter/Return to select them).

![Three tab interface with Tab 1 selected and only its contents are displayed. The contents of other tabs are hidden. If a tab is selected, then it's text-color changes from black to white and the background-color changes from orange-red to saddle brown.](tabbed-info-box.png)

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/learn/accessibility/html/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
<th scope="row">Prerequisites:</th>
<td>
A basic understanding of HTML (see
<a href="/en-US/docs/Learn/HTML/Introduction_to_HTML"

Check failure on line 17 in files/en-us/learn/accessibility/html/index.md

View workflow job for this annotation

GitHub Actions / check_url_issues

Slug 'learn/html/introduction_to_html' has been deleted
>Introduction to HTML</a
>), and an understanding of
<a href="/en-US/docs/Learn/Accessibility/What_is_accessibility"
Expand Down Expand Up @@ -396,7 +396,7 @@
```

> [!NOTE]
> You can find a lot more about link implementation and best practices in our [Creating hyperlinks](/en-US/docs/Learn/HTML/Introduction_to_HTML/Creating_hyperlinks) article. You can also see some good and bad examples at [good-links.html](https://mdn.github.io/learning-area/accessibility/html/good-links.html) and [bad-links.html](https://mdn.github.io/learning-area/accessibility/html/bad-links.html).
> You can find a lot more about link implementation and best practices in our [Creating links](/en-US/docs/Learn_web_development/Core/Structuring_content/Creating_links) article. You can also see some good and bad examples at [good-links.html](https://mdn.github.io/learning-area/accessibility/html/good-links.html) and [bad-links.html](https://mdn.github.io/learning-area/accessibility/html/bad-links.html).

Form labels are also important for giving you a clue about what you need to enter into each form input. The following seems like a reasonable enough example:

Expand Down Expand Up @@ -465,7 +465,7 @@
- The {{htmlelement("caption")}} element and the `<table>` element's `summary` attribute both do similar jobs — they act as alt text for a table, giving a screen reader user a useful quick summary of the table's contents. The `<caption>` element is generally preferred as it makes it's content accessible to sighted users too, who might also find it useful. You don't really need both.

> [!NOTE]
> See our [HTML table advanced features and accessibility](/en-US/docs/Learn/HTML/Tables/Advanced) article for more details about accessible data tables.
> See our [HTML table accessibility](/en-US/docs/Learn_web_development/Core/Structuring_content/Table_accessibility) article for more details about accessible data tables.

## Text alternatives

Expand Down Expand Up @@ -511,7 +511,7 @@
One thing to consider is whether your images have meaning inside your content, or whether they are purely for visual decoration, and thus have no meaning. If they are decorative, it is better to write an empty text as a value for `alt` attribute (see [Empty alt attributes](#empty_alt_attributes)) or to just include them in the page as CSS background images.

> [!NOTE]
> Read [Images in HTML](/en-US/docs/Learn/HTML/Multimedia_and_embedding/Images_in_HTML) and [Responsive images](/en-US/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images) for a lot more information about image implementation and best practices.
> Read [HTML images](/en-US/docs/Learn_web_development/Core/Structuring_content/HTML_images) and [Responsive images](/en-US/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images) for a lot more information about image implementation and best practices.

If you do want to provide extra contextual information, you should put it in the text surrounding the image, or inside a `title` attribute, as shown above. In this case, most screen readers will read out the alt text, the title attribute, and the filename. In addition, browsers display title text as tooltips when moused over.

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/learn/accessibility/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ page-type: learn-module

{{LearnSidebar}}

Learning some HTML, CSS, and JavaScript is useful if you want to become a web developer. Beyond mechanical use, it's important to learn how to use these technologies **responsibly** so that all readers might use your creations on the web. To help you achieve this, this module will cover general best practices (which are demonstrated throughout the [HTML](/en-US/docs/Learn/HTML), [CSS](/en-US/docs/Learn/CSS), and [JavaScript](/en-US/docs/Learn/JavaScript) topics), [cross browser testing](/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing), and some tips on enforcing accessibility from the start. We'll cover accessibility in special detail.
Learning some HTML, CSS, and JavaScript is useful if you want to become a web developer. Beyond mechanical use, it's important to learn how to use these technologies **responsibly** so that all readers might use your creations on the web. To help you achieve this, this module will cover general best practices (which are demonstrated throughout the [HTML](/en-US/docs/Learn/HTML), [CSS](/en-US/docs/Learn_web_development/Core/Styling_basics), and [JavaScript](/en-US/docs/Learn/JavaScript) topics), [cross browser testing](/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing), and some tips on enforcing accessibility from the start. We'll cover accessibility in special detail.

## Overview

Expand All @@ -24,7 +24,7 @@ The Firefox Accessibility Inspector is a very useful tool for checking out acces

## Prerequisites

To get the most out of this module, it would be a good idea to either work through at least the first two modules of the [HTML](/en-US/docs/Learn/HTML), [CSS](/en-US/docs/Learn/CSS), and [JavaScript](/en-US/docs/Learn/JavaScript) topics, or perhaps even better, work through the relevant parts of the accessibility module as you work through the related technology topics.
To get the most out of this module, it would be a good idea to either work through at least the first two modules of the [HTML](/en-US/docs/Learn/HTML), [CSS](/en-US/docs/Learn_web_development/Core/Styling_basics), and [JavaScript](/en-US/docs/Learn/JavaScript) topics, or perhaps even better, work through the relevant parts of the accessibility module as you work through the related technology topics.

> [!NOTE]
> If you are working on a computer/tablet/other devices where you don't have the ability to create your own files, you can try out most of the code examples in an online coding program such as [JSBin](https://jsbin.com/) or [Glitch](https://glitch.com/).
Expand Down
Loading
Loading