Add a Motivating Applications section and remove explainer #92
Conversation
|
|
||
| WebUSB thus replaces native code and native SDKs with cross-platform hardware support and web-ready libraries. | ||
|
|
||
| ## Appendix: A Brief Introduction to USB |
There was a problem hiding this comment.
It'd be nice to include this sort of introduction, or a link to it, in the spec's introduction. Otherwise web programmers just kinda get dumped into a confusing pile of descriptors.
There was a problem hiding this comment.
I've included this as an appendix though it should probably be merged with the Terminology section in some way.
There was a problem hiding this comment.
It could also live as a sub-section of the introduction, but an appendix is fine for now.
index.bs
Outdated
| classes are incorporating computerized measurement and data logging into their | ||
| lessons. These tools require bundled software that may be difficult to install | ||
| on managed computers as every new native application adds overhead to an already | ||
| stressed IT department. Web-based hardware APIs will allow support for these |
There was a problem hiding this comment.
Maybe switch from future tense to present tense when talking about what WebUSB can do. After all, you're planning to ship in Chrome 60.
There was a problem hiding this comment.
Done. I think I only had one instance of future tense here.
index.bs
Outdated
| @@ -55,13 55,46 @@ because, instead of waiting for a new kind of device to be popular enough for | |||
| browsers to provide a specific API, new and innovative hardware can be built | |||
| for the web from day one. | |||
|
|
|||
| # Motivating Applications # {#motivating-applications} | |||
There was a problem hiding this comment.
Is the 3-D printer example from the explainer no longer a motivating application?
There was a problem hiding this comment.
I didn't want to include an example mentioning specific manufacturers in the specification. I have made it more generic to illustrate the concept of a "web driver".
At this point in the specification process the explainer is redundant as the introductory information is now included in the specification. This change adds new "Motivating Applications" section and removes the separate explainer document, merging the brief tutorial on USB into a spec appendix. Resolves issues WICG#16 and WICG#90.
|
|
||
| WebUSB thus replaces native code and native SDKs with cross-platform hardware support and web-ready libraries. | ||
|
|
||
| ## Appendix: A Brief Introduction to USB |
There was a problem hiding this comment.
It could also live as a sub-section of the introduction, but an appendix is fine for now.
|
TAG flyby to say we strongly prefer standalone explainers. They're more accessible to developers and provide the space to be more comprehensive. |
At this point in the specification process the explainer is redundant as the introductory information is now included in the specification. This change adds new "Motivating Applications" section and removes the
separate explainer document.
Resolves issues #16 and #90.