Style - Revision history

Annevk: Moved to whatwg.org proper

2018-05-08T09:27:27Z

Moved to whatwg.org proper

← Older revision		Revision as of 09:27, 8 May 2018
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

Annevk: /* Dictionary */

2018-03-16T17:25:47Z

Dictionary

← Older revision		Revision as of 17:25, 16 March 2018
Line 7:		Line 7:
	* behavior		* behavior
	* bitrate		* bitrate
			* built-in (though see https://github.com/heycam/webidl/issues/350)
	* cancelation		* cancelation
	* canceled		* canceled

Annevk: /* Dictionary */

2018-01-24T09:09:34Z

Dictionary

← Older revision		Revision as of 09:09, 24 January 2018
Line 5:		Line 5:
	== Dictionary ==		== Dictionary ==

			* behavior
	* bitrate		* bitrate
	* cancelation		* cancelation

Annevk: /* Grammar */

2018-01-19T11:55:41Z

Grammar

← Older revision		Revision as of 11:55, 19 January 2018
Line 24:		Line 24:
	* Use the [https://en.wikipedia.org/wiki/Serial_comma Oxford Comma].		* 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.		* 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 ==		== Casing ==

Annevk: /* Dictionary */

2017-12-20T10:23:58Z

Dictionary

← Older revision		Revision as of 10:23, 20 December 2017
Line 11:		Line 11:
	* cipher		* cipher
	* colorspace		* colorspace
			* email
	* implementer		* implementer
	* keepalive (though HTTP Keep-Alive [sic] header)		* keepalive (though HTTP Keep-Alive [sic] header)

Annevk: /* Tone */

2017-12-20T10:19:13Z

Tone

← Older revision		Revision as of 10:19, 20 December 2017
Line 39:		Line 39:

	* Avoid using "simply" or suggesting that something is simple		* 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

Annevk: /* Dictionary */

2017-12-20T09:47:26Z

Dictionary

← Older revision		Revision as of 09:47, 20 December 2017
Line 9:		Line 9:
	* canceled		* canceled
	* canceling		* canceling
			* cipher
	* colorspace		* colorspace
	* implementer		* implementer

Annevk: /* Dictionary */

2017-11-17T15:57:04Z

Dictionary

← Older revision		Revision as of 15:57, 17 November 2017
Line 10:		Line 10:
	* canceling		* canceling
	* colorspace		* colorspace
			* implementer
	* keepalive (though HTTP Keep-Alive [sic] header)		* keepalive (though HTTP Keep-Alive [sic] header)
	* metadata		* metadata

Annevk: /* Dictionary */ we never settled newline / line break; we did settle nonzero

2017-09-22T11:41:34Z

Dictionary: we never settled newline / line break; we did settle nonzero

← Older revision		Revision as of 11:41, 22 September 2017
Line 12:		Line 12:
	* keepalive (though HTTP Keep-Alive [sic] header)		* keepalive (though HTTP Keep-Alive [sic] header)
	* metadata		* metadata
			* nonzero
	* referrer (though HTTP Referer [sic] header)		* referrer (though HTTP Referer [sic] header)
	* whitespace (though CSS white-space [sic] property)		* whitespace (though CSS white-space [sic] property)
	* newline (not line break)

	== Grammar ==		== Grammar ==

MikeSmith: Words and phrases used as words — use quotation marks

2017-07-13T09:10:29Z

Words and phrases used as words — use quotation marks

← Older revision		Revision as of 09:10, 13 July 2017
Line 32:		Line 32:

	== Words and phrases used as words ==		== 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, ~~either~~ enclose it in quotation marks ~~or in italics~~ (~~using <code><i>…<~~/~~i><~~/~~code>~~).		* 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 ==		== Tone ==

	* Avoid using "simply" or suggesting that something is simple		* Avoid using "simply" or suggesting that something is simple