This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 21405 - [editorial] Add a "Tag omission" subsection to the "head" of the spec section for each element
Summary: [editorial] Add a "Tag omission" subsection to the "head" of the spec section...
Status: RESOLVED FIXED
Alias: None
Product: WHATWG
Classification: Unclassified
Component: HTML (show other bugs)
Version: unspecified
Hardware: PC All
: P2 enhancement
Target Milestone: Unsorted
Assignee: Ian 'Hixie' Hickson
QA Contact: contributor
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-03-26 19:20 UTC by Michael[tm] Smith
Modified: 2013-04-01 17:03 UTC (History)
2 users (show)

See Also:


Attachments

Description Michael[tm] Smith 2013-03-26 19:20:52 UTC
This is a spec enhancement request.

Please add a "Tag omission" subsection to the "head" part of the section for each element; that is, the part that has "Content model", "Content attributes", "Contexts in which this element can be used", etc., headings.

http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#the-body-element

I'd be glad to provide a patch to add this for all elements.

The info that'd go into the "Tag omission" subsection is already in the spec at http://www.whatwg.org/specs/web-apps/current-work/multipage/syntax.html#optional-tags but for better usability of the spec by Web authors, it'd be good to also have it included at "point of use", in each element  section.

So for example for the <body> element, it'd look like this:

-----
Tag omission
  A body element's start tag may be omitted if the element is empty
  or if the first thing inside the body element is not a space
  character or a comment, except if the first thing inside the body
  element is a script or style element.

  A body element's end tag may be omitted if the body element is not
  immediately followed by a comment.
-----

Whereas the for the <script> element, it'd look like this:

-----
Tag omission
  A script element must have both a start tag and an end tag.
-----

Again, if we have agreement that this is a good idea, I'd be glad to provide a spec patch that adds it. Just lemme know.