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

    diff --git a/files/en-us/web/html/element/hgroup/index.html b/files/en-us/web/html/element/hgroup/index.html index 84a784679d3a85b..b8338276ff47d01 100644 --- a/files/en-us/web/html/element/hgroup/index.html +++ b/files/en-us/web/html/element/hgroup/index.html @@ -10,7 +10,13 @@ - Reference - Web --- -
    {{HTMLRef}}{{deprecated_header}}
    +
    {{HTMLRef}}
    + +
    +

    Warning

    +

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

    diff --git a/files/en-us/web/html/element/index.html b/files/en-us/web/html/element/index.html index f2081f6e38405a0..05d481b43b28043 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 completeness only.

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