icu4x icon indicating copy to clipboard operation
icu4x copied to clipboard

Links in tutorials point to version-non-specific crates

Open echeran opened this issue 8 months ago • 3 comments

In data-management.md, there is Markdown containing a link, such as

You can learn more about datagen, including the Rust API which we have not used in this tutorial, by reading [the docs](https://docs.rs/icu_datagen/latest/).ou can learn more about datagen, including the Rust API which we have not used in this tutorial, by reading [the docs](https://docs.rs/icu_datagen/latest/).

This may occur throughout the entire tutorials content.

However, as we've discussed, tutorials are inherently versioned content. Therefore, all such links should be versioned.

echeran avatar Mar 26 '25 23:03 echeran

CC @robertbastian

sffc avatar Mar 27 '25 05:03 sffc

This probably needs to be fixed by a script during copying to the website repo, as we can't update all the links everytime we bump a version number.

robertbastian avatar Mar 27 '25 08:03 robertbastian

So long as the repo links were valid at the time the tag was created, it seems harmless for the md-to-astro script to replace https://docs.rs/<XYZ>/latest/ with https://docs.rs/<XYZ>/<VERSION>/

sffc avatar Mar 27 '25 21:03 sffc