Document per-item versions using @since gates

[yoshuawuyts]

Depends on WebAssembly/component-model#332 to be merged first. This documents the stability of all items using the @since gate notation, enabling WIT documents to be updated over time without major compatibility hazards.

For an overview of how this would apply to all existing WASI APIs, including the unstable timezone API, see WebAssembly/WASI#604. Thanks!

[badeend]

Hi @yoshuawuyts . I'm not in the loop on these changes, so I've waited around a bit to see what the other repos (1 2 3 4 5) are doing. They haven't merged it either, so are "we" still waiting on something? Is it blocked by what you presented yesterday?

If not, I'd be happy to smack the Approve button for you 😛

[yoshuawuyts]

Now that WebAssembly/component-model#332 has been merged, you're right that there shouldn't be anything blocking this from moving forward. I'd be thrilled if we could land this!

As a small FYI, I did just update all the PRs also annotating the @use statements. This was based on WebAssembly/wasi-clocks#61 where we realized that versioning imports actually ends up being important, which we uncovered after a few cycles trying to get the new @unstable feature to pass CI.

I don't think that's anything major here, but I figured I should explain what I just pushed right after you asked me whether this should be good to land. With this change in now, I think this should be good to be merged!

[badeend]

Alright, great! Something to consider for your other PRs is that this also requires the CI pipeline to be updated. See the change to .github/workflows/main.yml I've just made.