Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Best Practices for Versioning WIT Packages in WASI Proposals #583

Open
Mossaka opened this issue Feb 15, 2024 · 1 comment
Open

Best Practices for Versioning WIT Packages in WASI Proposals #583

Mossaka opened this issue Feb 15, 2024 · 1 comment

Comments

@Mossaka
Copy link

Mossaka commented Feb 15, 2024

Hey there,

I am raising this issue to discuss whether or not we have a convention on naming WIT packages for WASI proposals, or should we have a convention for that?

With the launch of WASI 0.2, I observered that all WASI 0.2 proposals, including wasi:cli and wasi:http, are under the version v0.2.0. This approach is straightforward and understandable.

However, ambiguity arises with WIT packages in proposals that are at an early phase (1/0). The current practice seems to version these as v0.1.0, as seen in wasi-cloud-core's world.wit. This could potentially lead to confusion, implying a connection with WASI Preview 1 instead of indicating the package's development stage.

The aim of this issue is to discuss and establish best practices for versioning WIT packages in the context of WASI, especially for those not yet integrated into a preview release. Any recommendations would be greatly appreciated to ensure clarity and consistency across the ecosystem.

Thank you.

@pchickey
Copy link
Contributor

Prior to the 0.2.0 release, we used 0.2.0-rc-<iso 8601 date> as the format for versions in the cli/http and friends. If you want to imply something less stable than rc and not have to keep bumping versions as the contents change, you could use 0.2.0-draft.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants