Merge pull request #34209 from def-/pr-25.1-references

self-managed v26.0 docs and helm-chart version fixes

Author: def-

doc/developer/emulator.md

@@ -4,7 +4,7 @@ The emulator is a version of materialize used primarily for local testing. User
 
 ## How to profile the emulator
 
-Run the emulator using the following command to allow for local access to the heap dump endpoints for usage with the [debug tool](https://materialize.com/docs/self-managed/v25.1/integrations/mz-debug/).
+Run the emulator using the following command to allow for local access to the heap dump endpoints for usage with the [debug tool](https://materialize.com/docs/integrations/mz-debug/).
 
 ```bash
   docker run -d \

doc/user/content/get-started/install-materialize-emulator.md

@@ -101,7 +101,7 @@ not suitable for full feature set evaluations or production workloads.
   The full experience of Materialize is also available as a self-managed
   offering. See [Self-managed Materialize].
 
-[Self-managed Materialize]: https://materialize.com/docs/self-managed/v25.2/
+[Self-managed Materialize]: https://materialize.com/docs/installation/
 
 ### Technical Support
 

doc/user/content/get-started/quickstart.md

@@ -55,7 +55,7 @@ Emulator does not provide the full experience of using Materialize.
 
 - You can run against your [Self-managed Materialize].
 
-[Self-managed Materialize]: https://materialize.com/docs/self-managed/v25.2/
+[Self-managed Materialize]: https://materialize.com/docs/installation/
 
 ## Step 0. Open the SQL Shell
 

doc/user/content/integrations/api/versions.md

@@ -37,15 +37,16 @@ impl BuildInfo {
     /// Constructs a human-readable version string.
     pub fn human_version(&self, helm_chart_version: Option<String>) -> String {
         if let Some(ref helm_chart_version) = helm_chart_version {
-            format!(
-                "v{} ({}, helm chart: {})",
-                self.version,
-                &self.sha[..9],
-                helm_chart_version
-            )
-        } else {
-            format!("v{} ({})", self.version, &self.sha[..9])
+            if helm_chart_version != &self.version {
+                return format!(
+                    "v{} ({}, helm chart: {})",
+                    self.version,
+                    &self.sha[..9],
+                    helm_chart_version
+                );
+            }
         }
+        format!("v{} ({})", self.version, &self.sha[..9])
     }
 
     /// Returns the version as a rich [semantic version][semver].

doc/user/content/versions.json

@@ -350,10 +350,10 @@ pub struct Args {
     )]
     metadata_backend_url: Option<SensitiveUrl>,
 
-    /// Helm chart version for self-hosted Materialize. This version does not correspond to the
-    /// Materialize (core) version (v0.125.0), but is time-based for our twice-a-year helm chart
-    /// releases: v25.1.Z, v25.2.Z in 2025, then v26.1.Z, v26.2.Z in 2026, and so on. This version
-    /// is displayed in addition in `SELECT mz_version()` if set.
+    /// Helm chart version for self-hosted Materialize. This version is supposed to correspond to
+    /// the Materialize (core) version. This version is displayed in addition in `SELECT
+    /// mz_version()` if set and if it differs from the Materialize (core) version (which it should
+    /// not!).
     #[clap(long, env = "HELM_CHART_VERSION")]
     helm_chart_version: Option<String>,
 

src/build-info/src/lib.rs

@@ -901,7 +901,7 @@ impl SystemCatalogDumper {
                     let docs_link = if replica.is_none()
                         || replica.map_or(false, |r| r.cluster_name == "mz_catalog_server")
                     {
-                        "https://materialize.com/docs/self-managed/v25.1/installation/troubleshooting/#troubleshooting-console-unresponsiveness"
+                        "https://materialize.com/docs/installation/troubleshooting/#troubleshooting-console-unresponsiveness"
                     } else {
                         "https://materialize.com/docs/sql/alter-cluster/#resizing-1"
                     };

src/environmentd/src/environmentd/main.rs

@@ -133,7 +133,7 @@ def retry(fn: Callable, timeout: int) -> None:
 
 
 # TODO: Cover src/cloud-resources/src/crd/materialize.rs
-# TODO: Cover https://materialize.com/docs/self-managed/v25.2/installation/configuration/
+# TODO: Cover https://materialize.com/docs/installation/configuration/
 
 
 class Modification:
@@ -1218,7 +1218,7 @@ def workflow_defaults(c: Composition, parser: WorkflowArgumentParser) -> None:
 
     current_version = get_tag(args.tag)
 
-    # Following https://materialize.com/docs/self-managed/v25.2/installation/install-on-local-kind/
+    # Following https://materialize.com/docs/installation/install-on-local-kind/
     for version in reversed(get_self_managed_versions() + [current_version]):
         dir = "my-local-mz"
         if os.path.exists(dir):

src/mz-debug/src/system_catalog_dumper.rs

@@ -731,7 +731,7 @@ def setup(
 
     def upgrade(self, tag: str) -> None:
         print(f"--- Upgrading to {tag}")
-        # Following https://materialize.com/docs/self-managed/v25.1/installation/install-on-aws/upgrade-on-aws/
+        # Following https://materialize.com/docs/installation/install-on-aws/upgrade-on-aws/
         self.materialize_environment = {
             "apiVersion": "materialize.cloud/v1alpha1",
             "kind": "Materialize",