Skip to content

Commit 01c9796

Browse files
jyasskintorgo
andauthored
Give authors a choice whether to move their explainer into their spec.
Co-authored-by: Daniel Appelquist <dan@torgo.com>
1 parent b750177 commit 01c9796

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

index.bs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,9 @@ Follow the [tips](#tips) below to make your explainer as effective as possible.
5353
Once there is a reasonable amount of consensus on the approach and high-level design,
5454
use the explainer to guide spec writing.
5555
Start your specification using whatever tool you prefer
56-
(e.g. [Bikeshed](https://speced.github.io/bikeshed/) or [Respec](https://respec.org/)),
57-
and then move (don't copy) sections from your explainer into the specification.
58-
Be sure to leave links from the now-empty explainer sections
56+
(e.g. [Bikeshed](https://speced.github.io/bikeshed/) or [Respec](https://respec.org/)).
57+
You may want to move (not copy) sections from your explainer into the specification as you write it.
58+
If you do, be sure to leave links from the now-empty explainer sections
5959
to the specification sections that received their content.
6060

6161
As your specification evolves,

0 commit comments

Comments
 (0)