From 64f82436efba8dbd5cbc6ce48860d8ed294cc9db Mon Sep 17 00:00:00 2001
From: Jeff Bruemmer <jeff.bruemmer@gmail.com>
Date: Tue, 11 Jun 2024 10:38:15 -0400
Subject: [PATCH] docs - updates for 50 (#44002)

---
 docs/dashboards/introduction.md               |  2 +-
 docs/data-modeling/model-persistence.md       |  2 +-
 docs/databases/uploads.md                     |  2 +-
 docs/databases/users-roles-privileges.md      | 30 +++++++++----------
 docs/exploration-and-organization/uploads.md  |  2 +-
 docs/paid-features/overview.md                |  6 ++--
 docs/questions/sharing/answers.md             |  4 +--
 docs/releases.md                              |  4 +++
 .../troubleshooting-guide/data-permissions.md |  2 +-
 docs/troubleshooting-guide/models.md          |  6 ++--
 docs/usage-and-performance-tools/tools.md     | 10 +++----
 11 files changed, 37 insertions(+), 33 deletions(-)

diff --git a/docs/dashboards/introduction.md b/docs/dashboards/introduction.md
index 62cc2059f64..b08f1cd0873 100644
--- a/docs/dashboards/introduction.md
+++ b/docs/dashboards/introduction.md
@@ -226,7 +226,7 @@ Combining fullscreen mode and auto refresh is a great way to keep your team in s
 
 {% include plans-blockquote.html feature="Caching dashboard results" %}
 
-See [Caching per dashboard](../configuring-metabase/caching.md#caching-per-dashboard).
+See [Caching per dashboard](../configuring-metabase/caching.md#dashboard-caching-policy).
 
 ## Sharing dashboards with public links
 
diff --git a/docs/data-modeling/model-persistence.md b/docs/data-modeling/model-persistence.md
index e837545cd42..7824a136cf5 100644
--- a/docs/data-modeling/model-persistence.md
+++ b/docs/data-modeling/model-persistence.md
@@ -58,7 +58,7 @@ To refresh a model's results, go to the model and click on the **i** info icon.
 
 ## View model persistence logs
 
-You can view the logs for model caching by clicking on the **gear** icon in the upper right and selecting **Admin settings** > **Tools** > **Model caching logs**. See [Admin tools](../usage-and-performance-tools/tools.md).
+You can view the logs for model persistence by clicking on the **gear** icon in the upper right and selecting **Admin settings** > **Tools** > **Model caching logs**. See [Admin tools](../usage-and-performance-tools/tools.md).
 
 ## Difference between persisted models and caching
 
diff --git a/docs/databases/uploads.md b/docs/databases/uploads.md
index 61c83ce714f..80a220be996 100644
--- a/docs/databases/uploads.md
+++ b/docs/databases/uploads.md
@@ -77,7 +77,7 @@ CSV files cannot exceed 50 MB in size.
 
 > While Metabase limits uploads to 50 MB, the server you use to run your Metabase may impose a lower limit. For example, the default client upload limit for [NGINX is 1 MB](https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size). So you may need to change your server settings to allow uploads up to 50 MB. People on Metabase Cloud don't have to worry about this.
 
-If you have a file larger than 50 MB, the workaround here is to split the data into multiple and [append those files to an existing model](../exploration-and-organization/collections.md#appending-to-a-model-created-by-an-upload).
+If you have a file larger than 50 MB, the workaround here is to split the data into multiple and [append those files to an existing model](../exploration-and-organization/uploads.md#appending-to-a-model-created-by-an-upload)
 
 ## Date formats
 
diff --git a/docs/databases/users-roles-privileges.md b/docs/databases/users-roles-privileges.md
index 6440efadb0b..ce3e78f8954 100644
--- a/docs/databases/users-roles-privileges.md
+++ b/docs/databases/users-roles-privileges.md
@@ -8,12 +8,12 @@ We recommend creating a `metabase` database user with the following database rol
 
 - [`analytics` for read access](#minimum-database-privileges) to any schemas or tables used for analysis.
 - Optional [`metabase_actions` for write access](#privileges-to-enable-actions) to tables used for Metabase actions.
-- Optional [`metabase_model_caching` for write access](#privileges-to-enable-model-caching) to the schema used for Metabase model caching.
+- Optional [`metabase_model_persistence` for write access](#privileges-to-enable-model-persistence) to the schema used for Metabase model persistence.
 
 Bundling your privileges into roles based on use cases makes it easier to manage privileges in the future (especially in [multi-tenant situations](#multi-tenant-permissions)). For example, you could:
 
 - Use the same `analytics` role for other BI tools in your [data stack](https://www.metabase.com/learn/databases/data-landscape#data-analysis-layer) that need read-only access to the analytics tables in your database.
-- Revoke the write access for `metabase_model_caching` without affecting the write access for `metabase_actions`.
+- Revoke the write access for `metabase_model_persistence` without affecting the write access for `metabase_actions`.
 
 ## Minimum database privileges
 
@@ -107,31 +107,31 @@ GRANT INSERT, UPDATE, DELETE ON "your_table" IN SCHEMA "your_schema" TO metabase
 GRANT metabase_actions TO metabase;
 ```
 
-## Privileges to enable model caching
+## Privileges to enable model persistence
 
-[Model caching](../data-modeling/models.md#model-caching) lets Metabase save query results to a specific schema in your database. Metabase's database user will need the `CREATE` privilege to set up the dedicated schema for model caching, as well as write access (`INSERT`, `UPDATE`, `DELETE`) to that schema.
+[Model persistence](../data-modeling/model-persistence.md) lets Metabase save query results to a specific schema in your database. Metabase's database user will need the `CREATE` privilege to set up the dedicated schema for model caching, as well as write access (`INSERT`, `UPDATE`, `DELETE`) to that schema.
 
 In addition to the [minimum database privileges](#minimum-database-privileges):
 
-- Create a new role called `metabase_model_caching`.
+- Create a new role called `metabase_model_persistence`.
 - Give the role `CREATE` access to the database.
-- Give the role `INSERT`, `UPDATE`, and `DELETE` privileges to the schema used for model caching.
-- Give the `metabase_model_caching` role to the `metabase` user.
+- Give the role `INSERT`, `UPDATE`, and `DELETE` privileges to the schema used for model persistence.
+- Give the `metabase_model_persistence` role to the `metabase` user.
 
 ```sql
--- Create a role to bundle database privileges for Metabase model caching.
-CREATE ROLE metabase_model_caching WITH LOGIN;
+-- Create a role to bundle database privileges for Metabase model persistence.
+CREATE ROLE metabase_model_persistence WITH LOGIN;
 
 -- If you don't want to give CREATE access to your database,
--- add the schema manually before enabling modeling caching.
-GRANT CREATE ON "database" TO metabase_model_caching;
+-- add the schema manually before enabling modeling persistence.
+GRANT CREATE ON "database" TO metabase_model_persistence;
 
--- Grant write privileges to the SCHEMA used for model caching.
-GRANT USAGE ON "your_schema" TO metabase_model_caching;
-GRANT INSERT, UPDATE, DELETE ON "your_model's_table" IN SCHEMA "your_schema" TO metabase_model_caching;
+-- Grant write privileges to the SCHEMA used for model persistence.
+GRANT USAGE ON "your_schema" TO metabase_model_persistence;
+GRANT INSERT, UPDATE, DELETE ON "your_model's_table" IN SCHEMA "your_schema" TO metabase_model_persistence;
 
 -- Grant role to the metabase user.
-GRANT metabase_model_caching TO metabase;
+GRANT metabase_model_persistence TO metabase;
 ```
 
 ## Privileges to enable uploads
diff --git a/docs/exploration-and-organization/uploads.md b/docs/exploration-and-organization/uploads.md
index 81af020a8d8..bd0bdf4d135 100644
--- a/docs/exploration-and-organization/uploads.md
+++ b/docs/exploration-and-organization/uploads.md
@@ -40,7 +40,7 @@ Instead of deleting a model and recreating it, you can replace the underlying da
 
 Like appending to uploaded models, replacing the uploaded CSV data with a new CSV file requires the columns and headings to match.
 
-If you [delete the uploaded table](../databases/uploads.md#deleting-uploaded-tables), you won't be able to replace the model's data.
+If you [delete the uploaded table](../databases/uploads.md#deleting-tables-created-by-uploads), you won't be able to replace the model's data.
 
 ## Further reading
 
diff --git a/docs/paid-features/overview.md b/docs/paid-features/overview.md
index d2eaed69a32..b1f195fda4e 100644
--- a/docs/paid-features/overview.md
+++ b/docs/paid-features/overview.md
@@ -79,9 +79,9 @@ Tools for keeping your Metabase organized, so people can find your most importan
 
 All Metabase editions include global caching controls. Paid plans includes additional caching options that let you control caching for individual questions.
 
-- [Caching questions](../configuring-metabase/caching.md#caching-per-question)
-- [Caching dashboards](../configuring-metabase/caching.md#caching-per-dashboard)
-- [Caching databases](../configuring-metabase/caching.md#caching-per-database)
+- [Caching questions](../configuring-metabase/caching.md#question-caching-policy)
+- [Caching dashboards](../configuring-metabase/caching.md#dashboard-caching-policy)
+- [Caching databases](../configuring-metabase/caching.md#database-caching-policy)
 
 ## Model persistence for individual models
 
diff --git a/docs/questions/sharing/answers.md b/docs/questions/sharing/answers.md
index 2f1a2b10ecd..1ab2a7fda8e 100644
--- a/docs/questions/sharing/answers.md
+++ b/docs/questions/sharing/answers.md
@@ -53,7 +53,7 @@ Open the **three dot** (...) menu to:
 Click the **info** icon to:
 
 - Add a description
-- Edit the [cache duration](../../configuring-metabase/caching.md#caching-per-question)\*
+- Edit the [cache duration](../../configuring-metabase/caching.md#question-caching-policy)\*
 - View [revision history](../../exploration-and-organization/history.md)
 
 \* Available on [paid plans](https://www.metabase.com/pricing/).
@@ -74,7 +74,7 @@ To use a saved question as the basis for another question, you can:
 
 {% include plans-blockquote.html feature="Caching question results" %}
 
-See [Caching per question](../../configuring-metabase/caching.md#caching-per-question).
+See [Caching per question](../../configuring-metabase/caching.md#question-caching-policy).
 
 ## Sharing questions with public links
 
diff --git a/docs/releases.md b/docs/releases.md
index ecd52ad7cdb..844e765c69d 100644
--- a/docs/releases.md
+++ b/docs/releases.md
@@ -19,6 +19,8 @@ To see what's new, check out all the [major release announcements](https://www.m
 
 ## Metabase Enterprise Edition releases
 
+- [v1.50.0](https://github.com/metabase/metabase/releases/tag/v1.50.0)
+- [v1.49.15](https://github.com/metabase/metabase/releases/tag/v1.49.15)
 - [v1.49.14](https://github.com/metabase/metabase/releases/tag/v1.49.14)
 - [v1.49.13](https://github.com/metabase/metabase/releases/tag/v1.49.13)
 - [v1.49.12](https://github.com/metabase/metabase/releases/tag/v1.49.12)
@@ -168,6 +170,8 @@ To see what's new, check out all the [major release announcements](https://www.m
 
 ## Metabase Open Source Edition releases
 
+- [v0.50.0](https://github.com/metabase/metabase/releases/tag/v0.50.0)
+- [v0.49.15](https://github.com/metabase/metabase/releases/tag/v0.49.15)
 - [v0.49.14](https://github.com/metabase/metabase/releases/tag/v0.49.14)
 - [v0.49.13](https://github.com/metabase/metabase/releases/tag/v0.49.13)
 - [v0.49.12](https://github.com/metabase/metabase/releases/tag/v0.49.12)
diff --git a/docs/troubleshooting-guide/data-permissions.md b/docs/troubleshooting-guide/data-permissions.md
index 87d8c47522d..7ecacf972e2 100644
--- a/docs/troubleshooting-guide/data-permissions.md
+++ b/docs/troubleshooting-guide/data-permissions.md
@@ -111,7 +111,7 @@ If you can’t solve your problem using the troubleshooting guides:
 [block-data-permission]: ../permissions/data.md#blocked-view-data-permission
 [cant-see-tables]: ./cant-see-tables.md
 [collection-permissions]: ../permissions/collections.md
-[data-access]: ../permissions/data.md#data-permissions
+[data-access]: ../permissions/data.md#data-permission-types
 [data-permissions]: ../permissions/data.md
 [discourse]: https://discourse.metabase.com/
 [groups]: ../people-and-groups/managing.md#groups
diff --git a/docs/troubleshooting-guide/models.md b/docs/troubleshooting-guide/models.md
index 505545403e9..d3121dde048 100644
--- a/docs/troubleshooting-guide/models.md
+++ b/docs/troubleshooting-guide/models.md
@@ -25,8 +25,8 @@ If your changes to a model's metadata or underlying question aren't showing up:
 ## Model performance is poor
 
 1. Use model persistence.
-    
-    - Metabase can [write back to your data warehouse][model-caching]. If you enable model caching, Metabase will read a pre-computed and materialized version of the model directly from the database instead of running the query from scratch. Please consider this option is only available in some supported data warehouses.
+
+    - Metabase can [write back to your data warehouse][model-persistence]. If you enable model persistence, Metabase will read a pre-computed and materialized version of the model directly from the database instead of running the query from scratch. Please consider this option is only available in some supported data warehouses.
 
 2. Optimize the underlying saved question or SQL query.
 
@@ -75,4 +75,4 @@ If you can’t solve your problem using the troubleshooting guides:
 [sql-explain-learn]: https://www.metabase.com/learn/sql-questions/sql-best-practices.html#explain
 [summary-tables-learn]: https://www.metabase.com/learn/administration/making-dashboards-faster.html#aggregate-data-ahead-of-time-with-summary-tables
 [troubleshooting-sandboxing]: ./sandboxing.md
-[model-caching]: https://www.metabase.com/docs/latest/data-modeling/models#model-caching
+[model-persistence]: https://www.metabase.com/docs/latest/data-modeling/model-persistence
diff --git a/docs/usage-and-performance-tools/tools.md b/docs/usage-and-performance-tools/tools.md
index 05e7e3c668f..e59d92f1313 100644
--- a/docs/usage-and-performance-tools/tools.md
+++ b/docs/usage-and-performance-tools/tools.md
@@ -24,9 +24,9 @@ You can select and rerun multiple questions at a time while you troubleshoot to
 
 Here you can view the:
 
-- [Models](../data-modeling/models.md) being cached,
-- The status of the last caching query,
-- When the model was last cached,
-- And who created the cache.
+- [Models](../data-modeling/models.md) being persisted
+- The status of the last model query refresh
+- When the model was last refreshed
+- And who created the persisted model
 
-You can also click the refresh icon to rerun the model's query to update its cache.
+You can also click the refresh icon to rerun the model's query to update its results.
-- 
GitLab