search

whatwg / infra

Infra Standard
https://infra.spec.whatwg.org/
Other
118 stars 95 forks source link

Cross-reference other infrastructure-like specs? #166

Open littledan opened 6 years ago

littledan commented 6 years ago

In particular, WebIDL and the TAG Promises guide provide other foundational infrastructure. Maybe this should link to them.

domenic commented 6 years ago

The idea is that this is mostly agnostic to the technology used. We used to have some Web IDL integration but specifically removed it. Similarly I don't think mentioning promises is appropriate for this level. I'm even a bit uncomfortable with the JavaScript List reference; that's mostly a hack around the fact that JavaScript doesn't build on Infra like it (IMO) should.

annevk commented 6 years ago

I think what needs to happen is:

  1. We merge TAG Promises into IDL (and formalize its algorithms at the same time, adding missing arguments to some, etc.)
  2. We make IDL depend more strongly on Infra and harmonize the type systems

I think at that point it should be clear that Infra is the bottom layer and IDL sits on top, with no need for cross-referencing.

annevk commented 6 years ago

(And yeah, if we can make JavaScript similarly depend on Infra that'd be grand, but as always, baby steps.)

littledan commented 6 years ago

the fact that JavaScript doesn't build on Infra like it (IMO) should.

That'd be great!

I think at that point it should be clear that Infra is the bottom layer and IDL sits on top, with no need for cross-referencing.

Would it be so bad to have links in both directions, with one of the directions just in a note? This could be useful for beginners like me.

annevk commented 6 years ago

If you see some way we could make that work, I don't think it would be bad per se.