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.

Sign up for GitHub

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

Replace deprecation with warning in hgroup #4977

Merged
merged 4 commits into from
May 14, 2021
Merged

Replace deprecation with warning in hgroup #4977

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
60ba4c0
Replace deprecation with warning in hgroup
hamishwillee May 13, 2021
86d5fbb
Add to content categories
hamishwillee May 13, 2021
892cad7
copy edit
chrisdavidmills May 14, 2021
48f7eda
copy edit
chrisdavidmills May 14, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions files/en-us/web/guide/html/content_categories/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,9 @@
<li>Specific content categories, which describe rare categories shared only by a few elements, sometimes only in a specific context.</li>
</ul>

<div class="note">
<p><strong>Note:</strong> A more detailed discussion of these content categories and their comparative functionalities is beyond the scope of this article; for that, you may wish to read the <a href="https://html.spec.whatwg.org/multipage/dom.html#kinds-of-content">relevant portions of the HTML specification</a>.</p>
<div class="notecard note">
<h4>Note</h4>
<p>A more detailed discussion of these content categories and their comparative functionalities is beyond the scope of this article; for that, you may wish to read the <a href="https://html.spec.whatwg.org/multipage/dom.html#kinds-of-content">relevant portions of the HTML specification</a>.</p>
</div>

<p><a href="/en-US/docs/Web/Guide/HTML/Content_categories/content_categories_venn.png"><img alt="A Venn diagram showing how the various content categories interrelate. The following sections explain these relationships in text." class="default internal" src="content_categories_venn.png"></a></p>
Expand Down Expand Up @@ -68,8 +69,9 @@ <h3 id="Heading_content">Heading content</h3>
<p>Though likely to contain heading content, the {{HTMLElement("header")}} is not heading content itself.</p>
</div>

<div class="note">
<p><strong>Note:</strong> The {{HTMLElement("hgroup")}} element was removed from the W3C HTML specification prior to HTML 5 being finalized, but is still part of the WHATWG specification and is at least partially supported by most browsers.</p>
<div class="notecard note">
<h4>Note</h4>
<p>The {{HTMLElement("hgroup")}} element is not recommended as it does not work properly with assistive technologies. It was removed from the W3C HTML specification prior to HTML 5 being finalized, but is still part of the WHATWG specification and is at least partially supported by most browsers.</p>
</div>

<h3 id="Phrasing_content">Phrasing content</h3>
Expand Down
8 changes: 7 additions & 1 deletion files/en-us/web/html/element/hgroup/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,13 @@
- Reference
- Web
---
<div>{{HTMLRef}}{{deprecated_header}}</div>
<div>{{HTMLRef}}</div>

<div class="notecard warning">
<h4>Warning</h4>
<p><code>&lt;hgroup&gt;</code> should not be used because no assistive technology supports it, and as a result it has a detrimental effect on assistance for headings placed within it.</p>
<p>For more information see the <a href="#usage_notes">Usage notes below</a>.</p>
</div>

<p>The <strong>HTML <code>&lt;hgroup&gt;</code> element</strong> represents a multi-level heading for a section of a document. It groups a set of <code><a href="/en-US/docs/Web/HTML/Element/Heading_Elements">&lt;h1&gt;–&lt;h6&gt;</a></code> elements.</p>

Expand Down
10 changes: 6 additions & 4 deletions files/en-us/web/html/element/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,9 @@

<p><span class="seoSummary">This page lists all the {{Glossary("HTML")}} {{Glossary("Element","elements")}}, which are created using {{Glossary("Tag", "tags")}}.</span> They are grouped by function to help you find what you have in mind easily. An alphabetical list of all elements is provided in the sidebar on every element's page as well as this one.</p>

<div class="note">
<p>For more information about the basics of HTML elements and attributes, see <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML#elements_%e2%80%94_the_basic_building_blocks">the section on elements in the Introduction to HTML article</a>.</p>
<div class="notecard note">
<h4>Note</h4>
<p>For more information about the basics of HTML elements and attributes, see <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML#elements_%e2%80%94_the_basic_building_blocks">the section on elements in the Introduction to HTML article</a>.</p>
</div>

<h2 id="Main_root">Main root</h2>
Expand Down Expand Up @@ -122,8 +123,9 @@ <h2 id="Web_Components">Web Components</h2>

<h2 id="Obsolete_and_deprecated_elements">Obsolete and deprecated elements</h2>

<div class="warning">
<p><strong>Warning:</strong> These are old HTML elements which are deprecated and should not be used. <strong>You should never use them in new projects, and should replace them in old projects as soon as you can.</strong> They are listed here for informational purposes only.</p>
<div class="notecard warning">
<h4>Warning</h4>
<p>These are old HTML elements which are deprecated and should not be used. <strong>You should never use them in new projects, and should replace them in old projects as soon as you can.</strong> They are listed here for completeness only.</p>
</div>

<p>{{HTMLRefTable({"include":["Deprecated","Obsolete"]})}}</p>