diff --git a/docs/README.md b/docs/README.md index 0c2c45ade49..6b8e944e546 100644 --- a/docs/README.md +++ b/docs/README.md @@ -192,6 +192,17 @@ Avoid. See [sets](#sets). ([#727](https://github.com/web-platform-dx/web-features/pull/727#discussion_r1537635491)) +##### styling … as … by default + +Use this phrase (or using another appropriate preposition, such as "styling in") to note conventional or standardized default styling. +The ellipses stand in for the thing being styled (e.g., "text") and the style itself (e.g., "italic"). +Use it before [_also known as_ text](#also-known-as). +For example: + + > The `` element represents side-comments and small print, like copyright and legal text, styling text in a reduced font size by default. + + ([#1403](https://github.com/web-platform-dx/web-features/pull/1403), [#1379](https://github.com/web-platform-dx/web-features/pull/1379)) + ##### usage Never use "usage" in the sense of "using." diff --git a/features/samp.yml b/features/samp.yml index 6b2b6aee248..298709a7fa4 100644 --- a/features/samp.yml +++ b/features/samp.yml @@ -1,5 +1,5 @@ name: -description: The `` element represents an in-line sample (or quoted) output from a computer program. Typically styled as monospaced type by default. +description: The `` element represents side-comments and small print, like copyright and legal text, styling text in a reduced font size by default. spec: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-samp-element group: html-elements compat_features: diff --git a/features/small.yml b/features/small.yml index bc767dad5fc..da1c21fe831 100644 --- a/features/small.yml +++ b/features/small.yml @@ -1,5 +1,5 @@ name: -description: The `` element represents side-comments and small print, like copyright and legal text, independent of its styled presentation. Typically styled in a reduced font size by default. +description: The `` element represents side-comments and small print, like copyright and legal text, independent of its styled presentation. Styled in a reduced font size by default. spec: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-small-element group: html-elements compat_features: