Add examples for "represents" with HTML elements

web-platform-dx · Aug 7, 2024 · 4b4a5e9 · 4b4a5e9
1 parent c5aeb81
commit 4b4a5e9
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/README.md b/docs/README.md
@@ -184,6 +184,11 @@ For example, prefer the "The feature writes to…" over "The feature provides wr
 ##### represents
 
 If an HTML element or other type doesn't obviously do anything, then it probably _represents_ something.
+Use _represents_ as a default for describing the behavior of HTML elements when no more specific verb makes sense.
+
+  - 👍 Recommended: The `<html>` element represents the top level of an HTML document…
+  - 👍 Recommended: The `<br>` element breaks lines in text.
+  - 👎 Not recommended: The `<br>` element represents a line break in text.
 
 ##### sets