Readme/Additional Features BA & BC: Move sections to new documents

See #25.
tc39 · Mar 26, 2018 · 05b42cc · 05b42cc
1 parent faa00a0
commit 05b42cc
Show file tree

Hide file tree

Showing 3 changed files with 86 additions and 86 deletions.
diff --git a/additional-feature-ba.md b/additional-feature-ba.md
@@ -1,3 +1,46 @@
+## Additional Feature BA
+Another additional feature – **bare awaited calls** – makes async function calls
+terser. It adds another mode to bare style: if a bare-style pipeline step is
+preceded by a `await`, then instead of a mere function call, it is an awaited
+function call. `value |> await object.asyncFunction` is equivalent to `await
+object.asyncFunction(value)`. This is backwards compatible with the [Core
+Proposal][] as well as all other [additional features][].
+
+[Additional Feature BA is **formally specified in in the draft
+specification**][formal BC].
+
+<table>
+<thead>
+<tr>
+<th>With smart pipelines
+<th>Status quo
+
+<tbody>
+<tr>
+<td>
+
+```js
+value
+|> # + '!'
+|> new User.Message(#)
+|> await stream.write
+|> console.log;
+```
+
+<td>
+
+```js
+console.log(
+  await stream.write(
+    new User.Message(
+      value + '!'
+    )
+  )
+);
+```
+
+</table>
+
 [“data-to-ink” visual ratio]: https://www.darkhorseanalytics.com/blog/data-looks-better-naked
 [“don’t break my code”]: ./goals.md#dont-break-my-code
 [“don’t make me overthink”]: ./goals.md#dont-make-me-overthink

diff --git a/additional-feature-bc.md b/additional-feature-bc.md
@@ -1,3 +1,46 @@
+## Additional Feature BC
+An additional feature – **bare constructor calls** – makes constructor calls
+terser. It adds a mode to bare style: if a bare-style pipeline step is preceded
+by a `new`, then instead of a function call, it is a constructor call. `value |>
+object.Constructor` is equivalent to `object.Constructor(value)`. This is
+backwards compatible with the [Core Proposal][] as well as all other [additional
+features][].
+
+[Additional Feature BC is **formally specified in in the draft
+specification**][formal BC].
+
+<table>
+<thead>
+<tr>
+<th>With smart pipelines
+<th>Status quo
+
+<tbody>
+<tr>
+<td>
+
+```js
+value
+|> # + '!'
+|> new User.Message
+|> await stream.write(#)
+|> console.log;
+```
+
+<td>
+
+```js
+console.log(
+  await stream.write(
+    new User.Message(
+      value + '!'
+    )
+  )
+);
+```
+
+</table>
+
 [“data-to-ink” visual ratio]: https://www.darkhorseanalytics.com/blog/data-looks-better-naked
 [“don’t break my code”]: ./goals.md#dont-break-my-code
 [“don’t make me overthink”]: ./goals.md#dont-make-me-overthink

diff --git a/readme.md b/readme.md
@@ -1766,92 +1766,6 @@ function castPath (value, object) {
 
 </table>
 
-## Additional Feature BC
-An additional feature – **bare constructor calls** – makes constructor calls
-terser. It adds a mode to bare style: if a bare-style pipeline step is preceded
-by a `new`, then instead of a function call, it is a constructor call. `value |>
-object.Constructor` is equivalent to `object.Constructor(value)`. This is
-backwards compatible with the [Core Proposal][] as well as all other [additional
-features][].
-
-[Additional Feature BC is **formally specified in in the draft
-specification**][formal BC].
-
-<table>
-<thead>
-<tr>
-<th>With smart pipelines
-<th>Status quo
-
-<tbody>
-<tr>
-<td>
-
-```js
-value
-|> # + '!'
-|> new User.Message
-|> await stream.write(#)
-|> console.log;
-```
-
-<td>
-
-```js
-console.log(
-  await stream.write(
-    new User.Message(
-      value + '!'
-    )
-  )
-);
-```
-
-</table>
-
-## Additional Feature BA
-Another additional feature – **bare awaited calls** – makes async function calls
-terser. It adds another mode to bare style: if a bare-style pipeline step is
-preceded by a `await`, then instead of a mere function call, it is an awaited
-function call. `value |> await object.asyncFunction` is equivalent to `await
-object.asyncFunction(value)`. This is backwards compatible with the [Core
-Proposal][] as well as all other [additional features][].
-
-[Additional Feature BA is **formally specified in in the draft
-specification**][formal BC].
-
-<table>
-<thead>
-<tr>
-<th>With smart pipelines
-<th>Status quo
-
-<tbody>
-<tr>
-<td>
-
-```js
-value
-|> # + '!'
-|> new User.Message(#)
-|> await stream.write
-|> console.log;
-```
-
-<td>
-
-```js
-console.log(
-  await stream.write(
-    new User.Message(
-      value + '!'
-    )
-  )
-);
-```
-
-</table>
-
 # Appendices
 ## Smart step syntax
 Most pipeline steps will use topic references in their steps. This style of