Start with usage examples

[jzaefferer]

The spec currently has three examples under "5 Fetch API", using ES6 syntax. Since the document is pretty long, it would help a lot to have some usage examples at the start of the spec, for example as part of the "Goals" section, similar to the examples in the Web Audio spec. I also suggest using at most ES5 syntax for those examples.

What would those examples accomplish? A lot of specs, including this one, are mostly written for implementers. Getting early feedback from users is generally desirable, but often hindered by the lack of usage examples. Adding those, or in this case, making them easier to find, would make the spec a lot more accessible.

[annevk]

I think having examples that push the boundaries a bit is fine. After all, ES6 syntax is already shipping, fetch() is not.

As for the placement of the examples. They are in the API section because the rest of the specification deals with something much larger. The fetching infrastructure for the entire platform.

I would be open to having an introduction section that explains the fetching infrastructure and includes examples (including <img crossorigin>, background-image, new Worker() etc.) though. Interested in writing that?

[jzaefferer]

an introduction that explains the fetching infrastructure and includes examples

That sounds very useful. I was coming from github's fetch polyfill and wasn't aware of the actual focus of the spec.

Interested in writing that?

Personally, no, but I'll ask people on the jQuery team about that.

[shospodarets]

I have provided some useful examples in my article: http://blog.gospodarets.com/fetch_in_action/
using ES5 syntax.
I can write some examples based on it (if somebody suggests which would be the best) or anyone else can use them.

[jzaefferer]

Nice!