Skip to content
This repository has been archived by the owner on Sep 11, 2018. It is now read-only.

Add explainer document #1

Closed
marcoscaceres opened this issue Aug 24, 2015 · 3 comments
Closed

Add explainer document #1

marcoscaceres opened this issue Aug 24, 2015 · 3 comments

Comments

@marcoscaceres
Copy link
Contributor

A short explainer document to accompany the spec would be useful. A great example is @slightlyoff's one for Service Workers:

https://github.com/slightlyoff/ServiceWorker/blob/master/explainer.md

@marcoscaceres
Copy link
Contributor Author

Elsewhere, @slightlyoff wrote:

The argument for why these operations need to be synchronous isn't clearly
presented (this looks and smells like I/O w/o a justified blocking
behavior, something we generally don't want). I was hoping the
authors would outline their thinking in a document that isn't
just spec + examples.

@marcoscaceres
Copy link
Contributor Author

Should move the "this is today" examples in the spec to the explainer.

@AshleyScirra
Copy link
Contributor

Added explainer.md.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants