add a standard for referring to HTML tags in code documentation

Problem/Motivation

State what you believe is wrong or missing from the current standards.

Benefits

If we adopted this change, the Drupal Project would benefit by ...

Three supporters required

1. https://www.drupal.org/u/ → {userid} (yyyy-mm-dd they added support)
2. https://www.drupal.org/u/ → {userid} (yyyy-mm-dd they added support)
3. https://www.drupal.org/u/ → {userid} (yyyy-mm-dd they added support)

Proposed changes

See #5

The original proposal had these options

... the SPAN element
... the span element
... the <span> element

1. {link to the documentation heading that is to change}

Add current text in blockquotes

When referring to HTML tags by name in textual documentation, always use angle brackets, lowercase, and no closing tag, e.g.: <em>. If you are providing a code snippet, use @code/@endcode instead.

2. Repeat the above for each page or sub-page that needs to be changed.

Remaining tasks

2. Add supporters
3. Create a Change Record
4. Review by the Coding Standards Committee
5. Coding Standards Committee takes action as required
6. Discussed by the Core Committer Committee, if it impacts Drupal Core
7. Final review by Coding Standards Committee
8. Documentation updates
   1. Edit all pages
   2. Publish change record
   3. Remove 'Needs documentation edits' tag
9. If applicable, create follow-up issues for PHPCS rules/sniffs changes

For a full explanation of these steps see the Coding Standards project page →