Skip to content

Commit 5e1629a

Browse files
authored
Add shorthand and longhand property styleguide entry (#1891)
1 parent b806b26 commit 5e1629a

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/guidelines.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -195,6 +195,18 @@ Omit "is used" where there's no loss in meaning.
195195
For example, prefer "The feature reads…" over "The feature is used to read…"
196196
([#727](https://github.com/web-platform-dx/web-features/pull/727#discussion_r1537635981))
197197

198+
#### longhands and shorthands
199+
200+
Use the terms "shorthand" and "longhand" to describe the relationship between CSS properties that combine multiple properties into a single declaration and the individual properties.
201+
202+
Avoid using "shorthand" and "longhand" without the word "property":
203+
204+
* Prefer "The `text-wrap` CSS property is a shorthand" over "The `text-wrap` CSS shorthand".
205+
* Prefer "It is a longhand property of" over "It is a longhand of".
206+
207+
Avoid the phrase "constituent properties" for longhand properties, even though this is common on MDN Web Docs.
208+
([#1764](https://github.com/web-platform-dx/web-features/pull/1764#discussion_r1777335770))
209+
198210
#### platform
199211

200212
"platform" is often vague.

0 commit comments

Comments
 (0)