From 60ba4c0a0d49fd839505bcc64e61e47741949bee Mon Sep 17 00:00:00 2001 From: Hamish Willee Date: Fri, 14 May 2021 09:31:01 +1000 Subject: [PATCH 1/4] Replace deprecation with warning in hgroup --- files/en-us/web/html/element/hgroup/index.html | 9 ++++++++- files/en-us/web/html/element/index.html | 10 ++++++---- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/files/en-us/web/html/element/hgroup/index.html b/files/en-us/web/html/element/hgroup/index.html index 84a784679d3a85b..1164f664c09cfc9 100644 --- a/files/en-us/web/html/element/hgroup/index.html +++ b/files/en-us/web/html/element/hgroup/index.html @@ -10,7 +10,14 @@ - Reference - Web --- -
{{HTMLRef}}{{deprecated_header}}
+
{{HTMLRef}}
+ +
+

Warning

+

<hgroup> should not be used because no assistive technology supports it, and because has a detrimental effect on assistance for headings placed within it.

+

For more information see the Usage notes below.

+ +

The HTML <hgroup> element represents a multi-level heading for a section of a document. It groups a set of <h1>–<h6> elements.

diff --git a/files/en-us/web/html/element/index.html b/files/en-us/web/html/element/index.html index f2081f6e38405a0..8da5419f0b803f3 100644 --- a/files/en-us/web/html/element/index.html +++ b/files/en-us/web/html/element/index.html @@ -13,8 +13,9 @@

This page lists all the {{Glossary("HTML")}} {{Glossary("Element","elements")}}, which are created using {{Glossary("Tag", "tags")}}. 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.

-
-

For more information about the basics of HTML elements and attributes, see the section on elements in the Introduction to HTML article.

+
+

Note

+

For more information about the basics of HTML elements and attributes, see the section on elements in the Introduction to HTML article.

Main root

@@ -122,8 +123,9 @@

Web Components

Obsolete and deprecated elements

-
-

Warning: These are old HTML elements which are deprecated and should not be used. You should never use them in new projects, and should replace them in old projects as soon as you can. They are listed here for informational purposes only.

+
+

Warning

+

These are old HTML elements which are deprecated and should not be used. You should never use them in new projects, and should replace them in old projects as soon as you can. They are listed here for informational purposes only.

{{HTMLRefTable({"include":["Deprecated","Obsolete"]})}}

From 86d5fbb9bf2a36176fe9ef244f0ce8217df95fba Mon Sep 17 00:00:00 2001 From: Hamish Willee Date: Fri, 14 May 2021 09:38:59 +1000 Subject: [PATCH 2/4] Add to content categories --- .../en-us/web/guide/html/content_categories/index.html | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/files/en-us/web/guide/html/content_categories/index.html b/files/en-us/web/guide/html/content_categories/index.html index 18b39f8fde6e415..b5c48640ae67f49 100644 --- a/files/en-us/web/guide/html/content_categories/index.html +++ b/files/en-us/web/guide/html/content_categories/index.html @@ -19,8 +19,9 @@
  • Specific content categories, which describe rare categories shared only by a few elements, sometimes only in a specific context.
    • -
    -

    Note: 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 relevant portions of the HTML specification.

    +
    +

    Note

    +

    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 relevant portions of the HTML specification.

    A Venn diagram showing how the various content categories interrelate. The following sections explain these relationships in text.

    @@ -68,8 +69,9 @@

    Heading content

    Though likely to contain heading content, the {{HTMLElement("header")}} is not heading content itself.

    -
    -

    Note: 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.

    +
    +

    Note

    +

    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.

    Phrasing content

    From 892cad7d00392c547023e50ddf066172e4084041 Mon Sep 17 00:00:00 2001 From: Chris Mills Date: Fri, 14 May 2021 09:00:27 +0100 Subject: [PATCH 3/4] copy edit --- files/en-us/web/html/element/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/html/element/index.html b/files/en-us/web/html/element/index.html index 8da5419f0b803f3..05d481b43b28043 100644 --- a/files/en-us/web/html/element/index.html +++ b/files/en-us/web/html/element/index.html @@ -125,7 +125,7 @@

    Obsolete and deprecated elements

    Warning

    -

    These are old HTML elements which are deprecated and should not be used. You should never use them in new projects, and should replace them in old projects as soon as you can. They are listed here for informational purposes only.

    +

    These are old HTML elements which are deprecated and should not be used. You should never use them in new projects, and should replace them in old projects as soon as you can. They are listed here for completeness only.

    {{HTMLRefTable({"include":["Deprecated","Obsolete"]})}}

    From 48f7eda3300ab2d306697de85bb8b3321917a7a3 Mon Sep 17 00:00:00 2001 From: Chris Mills Date: Fri, 14 May 2021 09:01:29 +0100 Subject: [PATCH 4/4] copy edit --- files/en-us/web/html/element/hgroup/index.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/files/en-us/web/html/element/hgroup/index.html b/files/en-us/web/html/element/hgroup/index.html index 1164f664c09cfc9..b8338276ff47d01 100644 --- a/files/en-us/web/html/element/hgroup/index.html +++ b/files/en-us/web/html/element/hgroup/index.html @@ -14,9 +14,8 @@

    Warning

    -

    <hgroup> should not be used because no assistive technology supports it, and because has a detrimental effect on assistance for headings placed within it.

    +

    <hgroup> 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.

    For more information see the Usage notes below.

    -

    The HTML <hgroup> element represents a multi-level heading for a section of a document. It groups a set of <h1>–<h6> elements.