Fix the about->guide link

website/Cargo.toml

@@ -34,7 +34,9 @@ pulldown-cmark = "0.9.1"
 # Convert pulldown-cmark Events back to the string they were parsed from
 pulldown-cmark-to-cmark = "10.0.1"
 # A generic serialization/deserialization framework
-serde = "1.0.136"
+serde = { version = "1.0.136", features = ["derive"] }
+# A native Rust encoder and decoder of TOML-formatted files and streams.
+toml = "0.8.12"
 # Recursively walk a directory.
 walkdir = "2.5.0"
 # Easy support for interacting between JS and Rust.

website/xtask/Cargo.toml

@@ -8,4 +8,6 @@ anyhow = { workspace = true }
 fs_extra = { workspace = true }
 pulldown-cmark = { workspace = true }
 pulldown-cmark-to-cmark = { workspace = true }
+serde = { workspace = true }
+toml = { workspace = true }
 walkdir = { workspace = true }

website/xtask/src/convert_docs.rs

@@ -8,6 +8,8 @@ use std::{
     path::{Path, PathBuf},
 };
 
+use crate::docs_info::DocsInfo;
+
 pub fn run() -> Result<()> {
     convert_single_page_doc(
         "about.md",
@@ -283,11 +285,11 @@ slug = \"{slug}\"
                 once(event).chain(None)
             }
             End(Link(link_type, url, title)) => {
-                let fixed_url = fix_doc_urls(&url, flags.fix_url_mode).into();
+                let fixed_url = fix_doc_urls(&url, flags.fix_url_mode).unwrap().into();
                 once(End(Link(link_type, fixed_url, title))).chain(None)
             }
             End(FootnoteDefinition(url)) => {
-                let fixed_url = fix_doc_urls(&url, flags.fix_url_mode).into();
+                let fixed_url = fix_doc_urls(&url, flags.fix_url_mode).unwrap().into();
                 once(End(FootnoteDefinition(fixed_url))).chain(None)
             }
             Text(code) if in_koto_code => {
@@ -315,11 +317,17 @@ slug = \"{slug}\"
     Ok(output_buffer)
 }
 
-fn fix_doc_urls(url: &str, mode: FixUrlMode) -> String {
+fn fix_doc_urls(url: &str, mode: FixUrlMode) -> Result<String> {
     use FixUrlMode::*;
 
     let result = match mode {
-        TopLevelToLatest => url.replace("./language_guide.md", "/docs/latest/language/"),
+        TopLevelToLatest => {
+            let docs_info = DocsInfo::get_info()?;
+            url.replace(
+                "./language_guide.md",
+                &format!("/docs/{}/language/", docs_info.latest,),
+            )
+        }
         TopLevel => url
             .replace("./core_lib", "../core")
             .replace("./language_guide.md", "../language/"),
@@ -333,7 +341,10 @@ fn fix_doc_urls(url: &str, mode: FixUrlMode) -> String {
         result
     };
 
-    result
+    let result = result
         // Strip out .md suffixes
-        .replace(".md", "")
+        .replace(".md", "");
+
+    Ok(result)
 }
+

website/xtask/src/main.rs

@@ -3,6 +3,7 @@ use std::env::args;
 use anyhow::{bail, Result};
 
 mod convert_docs;
+mod docs_info;
 mod postprocess_playground;
 mod version_snapshot;
 

website/xtask/src/version_snapshot.rs

@@ -12,6 +12,8 @@ use std::{
 use anyhow::{bail, Context, Result};
 use walkdir::WalkDir;
 
+use crate::docs_info::DocsInfo;
+
 pub fn run(version: &str) -> Result<()> {
     let docs_target = format!("content/docs/{version}");
     let docs_target_path = PathBuf::from(&docs_target);
@@ -78,7 +80,10 @@ pub fn run(version: &str) -> Result<()> {
     let info_path = "content/docs/info.toml";
     let mut info_file =
         File::create(info_path).with_context(|| format!("failed to create file at {info_path}"))?;
-    writeln!(info_file, "latest = \"{version}\"")?;
+    let docs_info = DocsInfo {
+        latest: version.to_string(),
+    };
+    writeln!(info_file, "latest = \"{}\"", toml::to_string(&docs_info)?)?;
     println!("docs/info.toml updated");
 
     Ok(())