From 4dbebad3129574107842e7316581d01a94135320 Mon Sep 17 00:00:00 2001 From: Philip Chimento Date: Thu, 25 Aug 2022 16:37:17 -0700 Subject: [PATCH] Add skeleton editorial-conventions.md This can be a place to put items from https://github.com/tc39/ecma262/issues/2236 as they are discussed. I've pre-populated it with h2 headings that roughly match the kinds of conventions discussed in that issue. --- editorial-conventions.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 editorial-conventions.md diff --git a/editorial-conventions.md b/editorial-conventions.md new file mode 100644 index 0000000..f7fb05e --- /dev/null +++ b/editorial-conventions.md @@ -0,0 +1,18 @@ +# Editorial conventions when writing specification text + +This document describes some of the conventions that we try to follow when writing and editing specification text. Existing text may not follow these conventions exactly, but it should be updated eventually. + +> **NB.** The document is currently a skeleton, and should not be considered a complete list. +> The issue [tc39/ecma262#2236](https://github.com/tc39/ecma262/issues/2236) is a good place to discuss editorial conventions. + +## Spelling, grammar, and typography + +## Notation + +## Algorithm steps + +## Abstract operations + +## Implementations of functions and methods + +## Normative or editorial?