Style: Difference between revisions

Latest revision as of 09:27, 8 May 2018

This page has moved to WHATWG Style.

@@ Line 1: / Line 1: @@
-== Language ==
+{{moved|[https://whatwg.org/style-guide WHATWG Style].}}
-American English.
-== Dictionary ==
-* bitrate
-* cancelation
-* canceled
-* canceling
-* colorspace
-* keepalive (though HTTP Keep-Alive [sic] header)
-* metadata
-* referrer (though HTTP Referer [sic] header)
-* whitespace (though CSS white-space [sic] property)
-* newline (not line break)
-== Grammar ==
-* Use 's for possesives, even when it looks unnatural.
-* Use the [https://en.wikipedia.org/wiki/Serial_comma Oxford Comma].
-* Avoid "one of" unless it's followed by a bulleted list. You can normally leave it out and just use "or". If you cannot leave it out, that might be a good indication you want to use a bulleted list for clarity.
-== Casing ==
-* web, unless at the start of a sentence
-== Punctuation ==
-* Spaces around — (em dash)
-* Lowercase after colon (''The slot attribute is used to assign a slot to an element: an element with a slot attribute is assigned to the slot created by the slot element whose name attribute's value matches that slot attribute's value'')
-== Words and phrases used as words ==
-* When a word or term is not used functionally but is referred to as the word or term itself, enclose it in quotation marks. (See also: [http://www.chicagomanualofstyle.org/qanda/data/faq/topics/NoneoftheAbove/faq0012.html some examples that highlight why this is necessary].)
-== Tone ==
-* Avoid using "simply" or suggesting that something is simple