Skip to content

Conversation

@alexcrichton
Copy link
Member

With Wasmtime's LTS
releases
this commit documents the various process changes and updates to our release process. Additionally some improvements are made to the release documentation with respect to showing current versions.

With Wasmtime's [LTS
releases](bytecodealliance/rfcs#42) this commit
documents the various process changes and updates to our release
process. Additionally some improvements are made to the release
documentation with respect to showing current versions.

In more visual form this is a gantt chart of the current release trains:

<!-- JS edits in the chart -->
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An example of what this generates:

Screenshot 2025-03-27 at 3 08 49 PM

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is some impressive DOM-tree-editing hackery! The end result looks great.

At the risk of complexifying a little bit: could we add a placeholder ("view this document as HTML in a browser with JavaScript enabled to see contents" or somesuch) so that if the Markdown is processed in some other way -- for example, converted to print pdf by pandoc -- or viewed by a user with JS disabled, they aren't confused?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI, you should be able to use a <noscript> tag for this.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good yeah, added some <noscript> tags to indicate that it's empty without JS

@alexcrichton
Copy link
Member Author

I originally wanted to document the property of "when backporting must update all branches" and got a bit carried away and went ahead and documented the LTS updates.

Copy link
Member

@fitzgen fitzgen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you put version numbers in the JS's file paths so that if we ever want/need to upgrade, things are a little easier?

@github-actions github-actions bot added wasmtime:api Related to the API of the `wasmtime` crate itself wasmtime:docs Issues related to Wasmtime's documentation labels Mar 27, 2025
@alexcrichton alexcrichton marked this pull request as ready for review March 31, 2025 18:49
@alexcrichton alexcrichton requested review from a team as code owners March 31, 2025 18:49
@alexcrichton alexcrichton requested review from dicej and removed request for a team March 31, 2025 18:49
@alexcrichton alexcrichton added this pull request to the merge queue Mar 31, 2025
Merged via the queue into bytecodealliance:main with commit 2de55cc Mar 31, 2025
41 checks passed
@alexcrichton alexcrichton deleted the lts-documentation branch March 31, 2025 19:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

wasmtime:api Related to the API of the `wasmtime` crate itself wasmtime:docs Issues related to Wasmtime's documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants