search

dslomov / typed-objects-es7

ES7 typed objects spec draft
127 stars 7 forks source link

Demonstrate informal examples somewhere. #12

Open Raynos opened 10 years ago

Raynos commented 10 years ago

It would be useful for people that are not familiar with specifications to see informal examples of typed objects to get a reasonable understanding of what they and what problem domain they solve.

dslomov commented 10 years ago

We have informal introduction here: http://wiki.ecmascript.org/doku.php?id=harmony:typed_objects. Does it fit the bill?

domenic commented 10 years ago

Is it up to date? Anything on the wiki makes me automatically suspicious :).

In any case it should ideally be moved here to an Explainer.md or similar.

dslomov commented 10 years ago

Yes, I try to keep it up-to-date. We need to have something on a wiki, so I prefer the wiki to be an explainer and this be the spec.

domenic commented 10 years ago

IMO the wiki is a lost cause and nobody trusts it anymore. But if you want to try to save its reputation then up to you. shrug

Raynos commented 10 years ago

In that case add a "for informal ex platoon see wiki (link)" section to the readme :)

bterlson commented 10 years ago

I'd prefer to not use the wiki at all as it has no credibility...

I am hoping @wycats's guidelines for ECMAScript proposals will have a template that includes adding motivating use cases to Readme.md. Does that seem problematic?

dslomov commented 10 years ago

No it does not. If that is what we all do, I'll move it here (in this repo, Readme.md is the spec itself, but that is easily changable)

domenic commented 10 years ago

This might not be the best place to discuss the finer points of @wycats's proposal proposal but IMO the readme-as-spec works really well and a separate Explainer.md helps keep things separate.

bterlson commented 10 years ago

Yes, good point Domenic, the correct place to discuss this is here: https://github.com/tc39/ecma262/issues/3. (I like your proposal, though!)

peter-lyons-kehl commented 6 years ago

Thanks Dmitry @dslomov.

Wiki is down. Those that need an example, see http://smallcultfollowing.com/babysteps/pubs/2014.04.01-TypedObjects.pdf and https://github.com/dslomov/structs.js.