diff --git a/doc/user/assets/sass/_layout.scss b/doc/user/assets/sass/_layout.scss index 308ae4ebd1e0c..91ba8c7b4d97e 100644 --- a/doc/user/assets/sass/_layout.scss +++ b/doc/user/assets/sass/_layout.scss @@ -10,10 +10,10 @@ .content-wrapper { display: flex; justify-content: center; - padding-top: calc(var(--nav-height) + var(--small)); + padding-top: var(--nav-height); @media(max-width: 800px) { - padding-top: calc(var(--nav-height) + var(--small)); + padding-top: calc(var(--nav-height) + var(--xx-small)); } @media(max-width: 380px) { @@ -139,7 +139,7 @@ table.inline-headings { z-index: 100; top: var(--nav-height); left: 0; - height: calc(120vh - var(--nav-height)); + height: calc(100vh - var(--nav-height)); border-right: 1px solid var(--divider-light); transform: translateX(-100%); transition: all .2s ease-out; @@ -193,7 +193,6 @@ table.inline-headings { @media(max-width: 850px) { padding-bottom: var(--large); height: calc(100vh - var(--nav-height)); - margin-top: 80px; } a { diff --git a/doc/user/assets/sass/_nav.scss b/doc/user/assets/sass/_nav.scss index 645956cfc5273..b99bfc77fc910 100644 --- a/doc/user/assets/sass/_nav.scss +++ b/doc/user/assets/sass/_nav.scss @@ -149,7 +149,7 @@ button.show-topics { display: none; - margin: var(--small) 0 var(--small) !important; + margin: 0 0 var(--small) !important; text-align: left; font-weight: 300; font-size: var(--base); @@ -171,7 +171,6 @@ button.close-topics { position: absolute; justify-content: center; align-items: center; - margin-top: 80px; top: 0; right: 0; transform: translateX(50%) translateY(50%); diff --git a/doc/user/config.toml b/doc/user/config.toml index ba031962e0a5e..feca0e7146670 100644 --- a/doc/user/config.toml +++ b/doc/user/config.toml @@ -7,7 +7,7 @@ disableKinds = ['taxonomy'] [params] repo = "//github.com/MaterializeInc/materialize" -bannerMessage = "**New: Self-Managed v26!** For details, see [Release Notes](/releases/).
**Note**: To upgrade from v25 to v26, you must [upgrade first to v25.2.16+](https://materialize.com/docs/self-managed/v25.2/release-notes/#v25216)." +bannerMessage = "" bannerLink = "" [frontmatter] diff --git a/doc/user/content/_index.md b/doc/user/content/_index.md index ae346880b9edb..2394b8a9049f1 100644 --- a/doc/user/content/_index.md +++ b/doc/user/content/_index.md @@ -11,4 +11,19 @@ aliases: # Materialize documentation -{{< include-md file="shared-content/materialize-intro.md" >}} +{{% include-from-yaml data="materialize_intro" +name="materialize-intro" %}} + +{{< callout >}} +## What's new! + +- **Self-Managed v26!** For details, see [Release Notes](/releases/). To upgrade + from v25 to v26, you must [upgrade first to + v25.2.16+](https://materialize.com/docs/self-managed/v25.2/release-notes/#v25216) + +- **New Terraforms for Self-Managed!** For details, see [Terraform releases](/releases/terraform-releases/). + +{{}} + +{{% include-from-yaml data="materialize_intro" +name="materialize-offerings" %}} diff --git a/doc/user/content/get-started/_index.md b/doc/user/content/get-started/_index.md index 13b1ead83f344..4fe2416507380 100644 --- a/doc/user/content/get-started/_index.md +++ b/doc/user/content/get-started/_index.md @@ -11,7 +11,11 @@ menu: weight: 5 --- -{{< include-md file="shared-content/materialize-intro.md" >}} +{{% include-from-yaml data="materialize_intro" +name="materialize-intro" %}} + +{{% include-from-yaml data="materialize_intro" +name="materialize-offerings" %}} ## Key features diff --git a/doc/user/content/releases/_index.md b/doc/user/content/releases/_index.md index f47c08e2ed528..dceba9ef2307f 100644 --- a/doc/user/content/releases/_index.md +++ b/doc/user/content/releases/_index.md @@ -11,8 +11,14 @@ aliases: --- {{< note >}} -Starting with the v26.1.0 release, Materialize releases on a weekly schedule for -both Cloud and Self-Managed. See [Release schedule](/releases/schedule) for details. + +- Starting with the v26.1.0 release, Materialize releases on a weekly schedule +for both Cloud and Self-Managed. See [Release schedule](/releases/schedule) for +details. + +- New Terraform modules for Self-Managed are now GA. For details, see [Terraform +releases](/releases/terraform-releases/). + {{}} ## v26.7.0 @@ -294,7 +300,6 @@ See also Upgrade Notes for release specific notes. See also [Version specific upgrade notes](/self-managed-deployments/upgrading/#version-specific-upgrade-notes). - ## See also - [Release Schedule](/releases/schedule/) diff --git a/doc/user/content/releases/terraform-releases.md b/doc/user/content/releases/terraform-releases.md new file mode 100644 index 0000000000000..29a85b444a936 --- /dev/null +++ b/doc/user/content/releases/terraform-releases.md @@ -0,0 +1,13 @@ +--- +title: "Self-Managed Terraform releases" +description: "Release notes for Self-Manage Terraform modules." +disable_list: true +menu: + main: + parent: "releases" + weight: 15 +--- + +New Terraform modules for Self-Managed are now GA. + +{{< yaml-table data="self_managed/unified_terraform_versions" >}} diff --git a/doc/user/content/self-managed-deployments/_index.md b/doc/user/content/self-managed-deployments/_index.md index fa1e353867992..125bb405187c0 100644 --- a/doc/user/content/self-managed-deployments/_index.md +++ b/doc/user/content/self-managed-deployments/_index.md @@ -4,7 +4,6 @@ description: "Learn about the key components and architecture of self-managed Ma disable_list: true aliases: - /self-hosted/concepts/ - - /self-managed-deployments/appendix/legacy/appendix-legacy-terraform-releases/ menu: main: identifier: "sm-deployments" @@ -327,6 +326,7 @@ which provides concrete examples and an opinionated model for deploying Material {{< yaml-table data="self_managed/terraform_list" >}} +See also [Terraform releases](/self-managed-deployments/release-versions/#terraform-releases). {{< /tab >}} {{< tab "Legacy Terraform Modules" >}} ### Legacy Terraform Modules diff --git a/doc/user/content/self-managed-deployments/release-versions.md b/doc/user/content/self-managed-deployments/release-versions.md index a200882295102..fc0c6ea9a15f8 100644 --- a/doc/user/content/self-managed-deployments/release-versions.md +++ b/doc/user/content/self-managed-deployments/release-versions.md @@ -12,3 +12,22 @@ aliases: ## V26 releases {{< yaml-table data="self_managed/self_managed_operator_compatibility" >}} + +## Terraform releases + +Materialize provides the following [**Terraform +modules**](https://github.com/MaterializeInc/materialize-terraform-self-managed/tree/main?tab=readme-ov-file#materialize-self-managed-terraform-modules) +as examples for deploying Materialize. + +{{< important >}} +These modules are intended for evaluation/demonstration purposes and for serving +as a template when building your own production deployment. The modules should +not be directly relied upon for production deployments: **future releases of the +modules will contain breaking changes.** Instead, to use as a starting point for +your own production deployment, either: +- Fork the repo and pin to a specific version; or +- Use the code as a reference when developing your own deployment. +{{}} + + +{{< yaml-table data="self_managed/unified_terraform_versions" >}} diff --git a/doc/user/data/materialize_intro.yml b/doc/user/data/materialize_intro.yml new file mode 100644 index 0000000000000..86615bc46f839 --- /dev/null +++ b/doc/user/data/materialize_intro.yml @@ -0,0 +1,15 @@ +- name: materialize-intro + content: | + Materialize is the live data layer for apps and AI agents. To keep results + up-to-date as new data arrives, Materialize incrementally updates results as + it ingests data rather than recalculating results from scratch. + +- name: materialize-offerings + content: | + Materialize is available as: + + | Offering | Description | Get Started | + |----------|-------------|-------------| + | **Materialize Cloud** | Materialize Cloud is a fully-managed service for Materialize. | 🚀 Sign up for a [free trial account](https://materialize.com/register/?utm_campaign=General&utm_source=documentation) on Materialize Cloud and try out the [Quickstart](/get-started/quickstart/). | + | **Materialize Self-Managed** | Deploy and operate Materialize in your Kubernetes environment. Whereas Materialize Cloud gives you a fully managed service, Materialize Self-Managed allows you to deploy Materialize in your own infrastructure.

{{< include-md file="shared-content/self-managed/editions-available.md" >}} | 🚀 [Install self-managed](/get-started/install/) and try out the [Quickstart](/get-started/quickstart/). | + | **Materialize Emulator** | Materialize Emulator is an all-in-one Docker image that provides the fastest way to get hands-on experience with Materialize for local development. | 🚀 [Download and run Materialize Emulator](/get-started/install-materialize-emulator/) and try out the [Quickstart](/get-started/quickstart/). | diff --git a/doc/user/data/self_managed/self_managed_operator_compatibility.yml b/doc/user/data/self_managed/self_managed_operator_compatibility.yml index cf8c0ed3891ed..f4a074b62dd1f 100644 --- a/doc/user/data/self_managed/self_managed_operator_compatibility.yml +++ b/doc/user/data/self_managed/self_managed_operator_compatibility.yml @@ -14,17 +14,12 @@ rows: orchestratord version: v26.6.0 environmentd version: v26.6.0 Release date: "2026-01-12" - Notes: "" + Notes: See [v26.6.0 release notes](/releases/#v2660). - Materialize Operator: v26.5.1 orchestratord version: v26.5.1 environmentd version: v26.5.1 Release date: "2025-12-23" - Notes: "" - - Materialize Operator: v26.5.0 - orchestratord version: v26.5.0 - environmentd version: v26.5.0 - Release date: "2025-12-23" - Notes: "" + Notes: See [v26.5.1 release notes](/releases/#v2651). - Materialize Operator: v26.4.0 orchestratord version: v26.4.0 environmentd version: v26.4.0 diff --git a/doc/user/data/self_managed/unified_terraform_versions.yml b/doc/user/data/self_managed/unified_terraform_versions.yml new file mode 100644 index 0000000000000..8152965fad2b5 --- /dev/null +++ b/doc/user/data/self_managed/unified_terraform_versions.yml @@ -0,0 +1,16 @@ +columns: + - column: "Terraform version" + - column: "Notable changes" + +rows: + +- "Terraform version": | + v1.0.2 + "Notable changes": | + General availability. Available for use with v26 or greater. + For examples on using the modules, see the following guides: + | Guide | Description | + | ------------- | -------| + | [Install on AWS](/self-managed-deployments/installation/install-on-aws/) |Uses Terraform module to deploy Materialize to AWS Elastic Kubernetes Service (EKS). + | [Install on Azure](/self-managed-deployments/installation/install-on-azure/) | Uses Terraform module to deploy Materialize to Azure Kubernetes Service (AKS). + | [Install on GCP](/self-managed-deployments/installation/install-on-gcp/) |Uses Terraform module to deploy Materialize to Google Kubernetes Engine(GKE). diff --git a/doc/user/layouts/partials/toc.html b/doc/user/layouts/partials/toc.html index bdf93615644e3..e8ed741699606 100644 --- a/doc/user/layouts/partials/toc.html +++ b/doc/user/layouts/partials/toc.html @@ -141,7 +141,7 @@

On this page

const scrollTop = window.pageYOffset || document.documentElement.scrollTop; return { id: h.id, - offset: rect.top + scrollTop - 125, // 65px banner + 60px menubar = 125px total + offset: rect.top + scrollTop - 65, // 65px banner + 60px menubar = 125px total }; }); const cutoff = $(document).height() - $(window).height() - SLOP; diff --git a/doc/user/shared-content/materialize-intro.md b/doc/user/shared-content/materialize-intro.md deleted file mode 100644 index 38c68ee17b262..0000000000000 --- a/doc/user/shared-content/materialize-intro.md +++ /dev/null @@ -1,34 +0,0 @@ -Materialize is the live data layer for apps and AI agents. - -To keep results up-to-date as new data arrives, Materialize incrementally -updates results as it ingests data rather than recalculating results from -scratch. - -Materialize is available as: - -- **Materialize Cloud**. Materialize Cloud is a fully-managed service for - Materialize. - - - 🚀 **To get started**, sign up for a [free trial - account](https://materialize.com/register/?utm_campaign=General&utm_source=documentation) - on Materialize Cloud and try out the [Quickstart](/get-started/quickstart/). - - -- **Materialize Self-Managed**. Deploy and operate Materialize in your - Kubernetes environment. Whereas Materialize Cloud gives you a fully managed - service, Materialize Self-Managed allows you to deploy Materialize in your own - infrastructure. - - {{< include-md file="shared-content/self-managed/editions-available.md" >}} - - - 🚀 **To get started**, [install self-managed](/get-started/install/) and try - out the [Quickstart](/get-started/quickstart/). - - -- **Materialize Emulator**. Materialize Emulator is an all-in-one Docker image - that provides the fastest way to get hands-on experience with Materialize - for local development. - - - 🚀 **To get started**, [download and run Materialize - Emulator](/get-started/install-materialize-emulator/) and try out the - [Quickstart](/get-started/quickstart/).