Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 3 additions & 4 deletions doc/user/assets/sass/_layout.scss
Original file line number Diff line number Diff line change
Expand Up @@ -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) {
Expand Down Expand Up @@ -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;
Expand Down Expand Up @@ -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 {
Expand Down
3 changes: 1 addition & 2 deletions doc/user/assets/sass/_nav.scss
Original file line number Diff line number Diff line change
Expand Up @@ -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);
Expand All @@ -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%);
Expand Down
2 changes: 1 addition & 1 deletion doc/user/config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ disableKinds = ['taxonomy']

[params]
repo = "//github.com/MaterializeInc/materialize"
bannerMessage = "**New: Self-Managed v26!** For details, see [Release Notes](/releases/).<br>**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]
Expand Down
17 changes: 16 additions & 1 deletion doc/user/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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](/self-managed-deployments/release-versions/#terraform-releases).

{{</ callout >}}

{{% include-from-yaml data="materialize_intro"
name="materialize-offerings" %}}
6 changes: 5 additions & 1 deletion doc/user/content/get-started/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
11 changes: 8 additions & 3 deletions doc/user/content/releases/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +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.
{{</ 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.

- New Terraform modules for Self-Managed are now GA. For details, see [Terraform
releases](/self-managed-deployments/release-versions/#terraform-releases). {{</
note >}}

## v26.4.0

Expand Down
2 changes: 1 addition & 1 deletion doc/user/content/self-managed-deployments/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down Expand Up @@ -326,6 +325,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
Expand Down
19 changes: 19 additions & 0 deletions doc/user/content/self-managed-deployments/release-versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
{{</ important >}}


{{< yaml-table data="self_managed/unified_terraform_versions" >}}
15 changes: 15 additions & 0 deletions doc/user/data/materialize_intro.yml
Original file line number Diff line number Diff line change
@@ -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.<br><br>{{< include-md file="shared-content/self-managed/editions-available.md" >}} | 🚀 [Install self-managed](/get-started/install/) and try out the [Quickstart](/get-started/quickstart/). |
Copy link
Contributor Author

Choose a reason for hiding this comment

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

The editions available table can go somewhere else ... but for now, can remain.

| **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/). |
16 changes: 16 additions & 0 deletions doc/user/data/self_managed/unified_terraform_versions.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
columns:
- column: "Terraform version"
- column: "Notable changes"

rows:

- "Terraform version": |
v1.0.2
Copy link
Contributor Author

Choose a reason for hiding this comment

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

It's actually probably v1.0.3 since v1.02 was from last week and we probably want the latest in main to be our GA.

https://github.com/MaterializeInc/materialize-terraform-self-managed/tags

"Notable changes": |
General availability. Available for use with v26 or greater.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

The GA release is always a slightly goofy one in notable changes but eh.

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).
2 changes: 1 addition & 1 deletion doc/user/layouts/partials/toc.html
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ <h2 class="gradient_text dark">On this page</h2>
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;
Expand Down
34 changes: 0 additions & 34 deletions doc/user/shared-content/materialize-intro.md

This file was deleted.