A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on IRC (such as one of these permanent autoconfirmed members).

Difference between revisions of "Style"

From WHATWG Wiki
Jump to: navigation, search
(Dictionary)
(Moved to whatwg.org proper)
 
Line 1: Line 1:
== Language ==
+
{{moved|[https://whatwg.org/style-guide WHATWG Style].}}
 
 
American English.
 
 
 
== Dictionary ==
 
 
 
* behavior
 
* bitrate
 
* built-in (though see https://github.com/heycam/webidl/issues/350)
 
* cancelation
 
* canceled
 
* canceling
 
* cipher
 
* colorspace
 
* email
 
* implementer
 
* keepalive (though HTTP Keep-Alive [sic] header)
 
* metadata
 
* nonzero
 
* referrer (though HTTP Referer [sic] header)
 
* whitespace (though CSS white-space [sic] property)
 
 
 
== 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.
 
* A hierarchy (not an).
 
 
 
== 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
 
* Don't use "white" as meaning good and "black" as meaning bad; more concretely, "safelist" and "blocklist" are established precedent
 

Latest revision as of 09:27, 8 May 2018

This page has moved to WHATWG Style.