Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: more typos (#72168)

Alex Yarosh97f95e40cd12
diff --git a/docs/cloud/limitations.md b/docs/cloud/limitations.md
index 8e9d64564ca..3e9f93cf521 100644
--- a/docs/cloud/limitations.md
+++ b/docs/cloud/limitations.md
@@ -10,7 +10,7 @@ redirect_from:
- /cloud/docs/limitations
---
-# Limitation of Metabase Cloud
+# Limitations of Metabase Cloud
There are some limitations that could impact your migration to Metabase Cloud. These limitations apply to all [Metabase Cloud plans](https://www.metabase.com/pricing/).
diff --git a/docs/cloud/migrate/cloud-to-self-hosted.md b/docs/cloud/migrate/cloud-to-self-hosted.md
index b6c6c930d22..66f421092ce 100644
--- a/docs/cloud/migrate/cloud-to-self-hosted.md
+++ b/docs/cloud/migrate/cloud-to-self-hosted.md
@@ -60,4 +60,4 @@ If you're migrating from a Metabase Cloud Pro plan to a self-hosted Pro plan, yo
4. **Pro plans will need to input a license token to activate the paid features**. If you're migrating to a Pro self-hosted plan, [activate your Enterprise Edition token](../../installation-and-operation/activating-the-enterprise-edition.md).
- If you're on a Pro Cloud plan, you'll need to cancel that plan and start a new self-hosted Pro plan to get the token you'll need to activate your paid features . See [Preparing to migrate from cloud to self-hosted](#preparing-to-migrate-from-cloud-to-self-hosted).
+ If you're on a Pro Cloud plan, you'll need to cancel that plan and start a new self-hosted Pro plan to get the token you'll need to activate your paid features. See [Preparing to migrate from cloud to self-hosted](#preparing-to-migrate-from-cloud-to-self-hosted).
diff --git a/docs/configuring-metabase/appearance.md b/docs/configuring-metabase/appearance.md
index 3dd42112333..d451de8aa11 100644
--- a/docs/configuring-metabase/appearance.md
+++ b/docs/configuring-metabase/appearance.md
@@ -68,7 +68,7 @@ Only a **limited subset** of custom colors will be used for:
- [Maps](../questions/visualizations/map.md)
- [Sunburst chart](../questions/visualizations/pie-or-donut-chart.md)
-In most cases, replacing default colors with custom chart colors will not be applied to
+In most cases, replacing default colors with custom chart colors will not be applied to existing charts.
## Icons
diff --git a/docs/configuring-metabase/custom-maps.md b/docs/configuring-metabase/custom-maps.md
index 2a4dff2493a..170a7cb2779 100644
--- a/docs/configuring-metabase/custom-maps.md
+++ b/docs/configuring-metabase/custom-maps.md
@@ -60,7 +60,7 @@ To add a custom map:
![Uploading a custom GeoJSON](./images/custom-geojson.png)
- **Name of the map** will be displayed in the region selector for [custom region maps](../questions/visualizations/map.md#custom-regions).
- - **Region's identifier** is a GeoJSON field that identifies your region. The values in this field should match how the data refers to the regions. The field doesn't need to match the display name .
+ - **Region's identifier** is a GeoJSON field that identifies your region. The values in this field should match how the data refers to the regions. The field doesn't need to match the display name.
- **Region's display name** is a GeoJSON field that specifies how maps will display region names. This field can be different from the region's identifier.
To pre-load one or more region maps when Metabase starts, you can use the environment variable [`MB_CUSTOM_GEOJSON`](./environment-variables.md#mb_custom_geojson) or a [config file option](./config-file.md) `custom-geojson` .
diff --git a/docs/configuring-metabase/localization.md b/docs/configuring-metabase/localization.md
index 0907d1129ef..43e2cd9cd76 100644
--- a/docs/configuring-metabase/localization.md
+++ b/docs/configuring-metabase/localization.md
@@ -107,7 +107,7 @@ To configure default separator settings:
_Admin > Settings > Localization_
-You can choose how should currency fields be displayed by default (you can configure _which_ fields should be displayed as currency in table metadata or in question formatting setting, see [Formatting](../data-modeling/formatting.md) )
+You can choose how currency fields should be displayed by default (you can configure _which_ fields should be displayed as currency in table metadata or in question formatting setting, see [Formatting](../data-modeling/formatting.md))
Note that people can also override these localization options for specific fields or questions.
diff --git a/docs/dashboards/actions.md b/docs/dashboards/actions.md
index a71e8491ca6..80951276fee 100644
--- a/docs/dashboards/actions.md
+++ b/docs/dashboards/actions.md
@@ -42,7 +42,7 @@ When people click the action button on a dashboard, they'll be prompted to input
To connect an action field to a filter on a dashboard:
-1. On a dashboard with an action button, click the **pencil icon** edit the dashboard.
+1. On a dashboard with an action button, click the **pencil icon** to edit the dashboard.
2. [Add a filter](./filters.md) to a dashboard, connect the filter to one or more cards, and click **Done** in the bottom of the sidebar.
3. [Add an action button to the dashboard](#add-an-action-button-to-a-dashboard) (if you haven't already).
4. Hover over the action button and click on the **gear** icon, and select **Change action**.
diff --git a/docs/dashboards/linked-filters.md b/docs/dashboards/linked-filters.md
index 81af4010927..1f893f5cbc4 100644
--- a/docs/dashboards/linked-filters.md
+++ b/docs/dashboards/linked-filters.md
@@ -48,7 +48,7 @@ Linked filters are only "aware" of relationships defined in the table metadata.
- Linked filters can't see relationships defined by joins in models or questions.
- Linked filters can't use any filter or join logic from any underlying card or model.
-For example, say you have a table with State and City columns, and you build a model that filters out rows with `City = San Francisco`. You ask a question based on that model, and add it to a dashboard. You add State and City filters to the dashboard, and link them. If you select were to select `State = CA`, the city filter may still show `San Francisco` as option, even though there are no records with `San Francisco` in the question and the underlying model, because the filter only "knows" about the underlying table metadata (which includes sample values for the column).
+For example, say you have a table with State and City columns, and you build a model that filters out rows with `City = San Francisco`. You ask a question based on that model, and add it to a dashboard. You add State and City filters to the dashboard, and link them. If you were to select `State = CA`, the city filter may still show `San Francisco` as option, even though there are no records with `San Francisco` in the question and the underlying model, because the filter only "knows" about the underlying table metadata (which includes sample values for the column).
### Linked filters don't work with custom columns or summaries
diff --git a/docs/dashboards/subscriptions.md b/docs/dashboards/subscriptions.md
index 73444e8a2b4..b96ba5b0957 100644
--- a/docs/dashboards/subscriptions.md
+++ b/docs/dashboards/subscriptions.md
@@ -59,7 +59,7 @@ You'll need to specify what time of day to send the dashboard, and, for weekly a
### Test subscription
-You can click **Send email/Slack now** in subscription settings to send a test email or Slack message (without waiting for regular schedule). This will send a subscriptions immediately to all subscribers or Slack channels.
+You can click **Send email/Slack now** in subscription settings to send a test email or Slack message (without waiting for regular schedule). This will send a subscription immediately to all subscribers or Slack channels.
We recommend first creating a subscription with a test email/channel, then using **Send email/Slack now** to test it, and once you are satisfied with the subscription, replacing the test email/channel with real recipients and saving the subscription.
diff --git a/docs/data-modeling/formatting.md b/docs/data-modeling/formatting.md
index 88c87af3b02..7ecdd77c23d 100644
--- a/docs/data-modeling/formatting.md
+++ b/docs/data-modeling/formatting.md
@@ -7,7 +7,7 @@ redirect_from:
# Formatting defaults
-People all around the world use Metabase, and everyone has different preferences for how dates, times, numbers, and currencies should be formatted and displayed. Metabase lets you to customize these formatting options at three different levels:
+People all around the world use Metabase, and everyone has different preferences for how dates, times, numbers, and currencies should be formatted and displayed. Metabase lets you customize these formatting options at three different levels:
1. **Global**. Set global defaults in Admin -> Settings -> [Localization](../configuring-metabase/localization.md).
2. **Field**. Set field (column) defaults in Admin -> Table Metadata. Field defaults override global defaults.
@@ -17,7 +17,7 @@ People all around the world use Metabase, and everyone has different preferences
_Admin > Table Metadata > Database > Table > Field > Formatting_
-You can override the global defaults for a specific field by going to the `Table Metadata` section of the Admin Panel. Select the database and table of the field in question, then click scroll down to the **Formatting**.
+You can override the global defaults for a specific field by going to the `Table Metadata` section of the Admin Panel. Select the database and table of the field in question, then scroll down to the **Formatting**.
## Formatting options depend on the data type and the semantic type
@@ -109,7 +109,7 @@ Whether to display the values in the middle, left, or right in table cells.
### Show a mini bar chart
-Only applies to table visualizations. Displays a bar for each value to show large or small it is relative to the other values in the column.
+Only applies to table visualizations. Displays a bar for each value to show how large or small it is relative to the other values in the column.
### Display as
diff --git a/docs/data-modeling/metadata-editing.md b/docs/data-modeling/metadata-editing.md
index aa399f89967..9c6d7c01509 100644
--- a/docs/data-modeling/metadata-editing.md
+++ b/docs/data-modeling/metadata-editing.md
@@ -153,7 +153,7 @@ _Admin > Table Metadata > Database > Table > Field_
### Semantic type
-You can change the [semantic type](../data-modeling/semantic-types.md) to give people more context and enable additional functionality, such as displaying text as an image (if the text is an image URL. Another example: you could set an Integer as a "Score" so people have a better idea what those integers indicate.
+You can change the [semantic type](../data-modeling/semantic-types.md) to give people more context and enable additional functionality, such as displaying text as an image (if the text is an image URL). Another example: you could set an Integer as a "Score" so people have a better idea what those integers indicate.
The semantic types you can choose from depend on the data type. If none of the options describe the values in the column, you can set this setting to "No semantic type".
diff --git a/docs/data-modeling/metrics.md b/docs/data-modeling/metrics.md
index 13e257dd945..a8456552757 100644
--- a/docs/data-modeling/metrics.md
+++ b/docs/data-modeling/metrics.md
@@ -113,7 +113,7 @@ You can use [custom expressions](../questions/query-builder/expressions.md) to d
(CountIf([Score] >= 9) - CountIf([Score] <= 6) ) / Count() * 100
```
-Metric formula must to be an _aggregation_ of a column, meaning you can have a formula like `Sum([Price])` which will add up all the values in the `Price` column across all records, but you can't have a formula like `[Price] + [Tax]` which adds two values on a per-record basis. If you need to create a "calculated" column, consider using [transforms](../data-studio/transforms/transforms-overview.md) or [models](../data-modeling/models.md) instead.
+Metric formula must be an _aggregation_ of a column, meaning you can have a formula like `Sum([Price])` which will add up all the values in the `Price` column across all records, but you can't have a formula like `[Price] + [Tax]` which adds two values on a per-record basis. If you need to create a "calculated" column, consider using [transforms](../data-studio/transforms/transforms-overview.md) or [models](../data-modeling/models.md) instead.
We don't recommend adding filters into the metric definition to avoid filter conflicts when using metrics in the query builder. You can use conditional custom expressions like [`CountIf`, `SumIf`, and `DistinctIf`](../questions/query-builder/expressions-list.md#aggregations) to create conditional aggregations.
diff --git a/docs/data-studio/dependency-diagnostics.md b/docs/data-studio/dependency-diagnostics.md
index 8e27ad99bd1..0fc23f9b5a3 100644
--- a/docs/data-studio/dependency-diagnostics.md
+++ b/docs/data-studio/dependency-diagnostics.md
@@ -5,7 +5,7 @@ summary: Find broken content and unused items so you can fix problems and clean
# Dependency diagnostics
-{% include plans-blockquote.html feature="Dependency disagnistics" %}
+{% include plans-blockquote.html feature="Dependency diagnostics" %}
Dependency diagnostics shows you content with broken dependencies, and content that isn't referenced by anything else.
diff --git a/docs/databases/connections/mariadb.md b/docs/databases/connections/mariadb.md
index f8114d24c86..aac283cec5a 100644
--- a/docs/databases/connections/mariadb.md
+++ b/docs/databases/connections/mariadb.md
@@ -60,7 +60,7 @@ You can append options to the connection string that Metabase uses to connect to
### Re-run queries for simple explorations
-Turn this option **OFF** if people want to click **Run** (the play button) before applying any [summarize](../../questions/query-builder/summarizing-and-grouping.md)) or [filter](../../questions/query-builder/filters.md) selections.
+Turn this option **OFF** if people want to click **Run** (the play button) before applying any [summarize](../../questions/query-builder/summarizing-and-grouping.md) or [filter](../../questions/query-builder/filters.md) selections.
By default, Metabase will execute a query as soon as you choose an grouping option from the **Summarize** menu or a filter condition from the [drill-through menu](https://www.metabase.com/learn/metabase-basics/querying-and-dashboards/questions/drill-through). If your database is slow, you may want to disable re-running to avoid loading data on each click.
diff --git a/docs/databases/connections/oracle.md b/docs/databases/connections/oracle.md
index d39f2a5549f..7fd62904c01 100644
--- a/docs/databases/connections/oracle.md
+++ b/docs/databases/connections/oracle.md
@@ -111,7 +111,7 @@ We recommend using the `ojdbc8.jar` JAR.
## Adding the Oracle JDBC Driver JAR to the Metabase plugins directory
-In your Metabase directory (the directory where you keep and run your metabase.jar), create a directory called `plugins` (if it doesn't already exist.
+In your Metabase directory (the directory where you keep and run your metabase.jar), create a directory called `plugins` (if it doesn't already exist).
Move the JAR you just downloaded (`ojdbc8.jar`) into the plugins directory, and restart Metabase. Metabase will automatically make the Oracle driver available when it starts back up.
diff --git a/docs/databases/connections/presto.md b/docs/databases/connections/presto.md
index c75062bb09c..fee2b34a434 100644
--- a/docs/databases/connections/presto.md
+++ b/docs/databases/connections/presto.md
@@ -70,7 +70,7 @@ Kerberos settings include:
- Kerberos credential cache file (e.g., `/tmp/kerbo-credential-cache`)
- Kerberos keytab file (e.g., `/path/to/kerberos.keytab`)
- Kerberos configuration file (e.g., `/etc/krb5.conf`)
-- Presto coordinator Kerberos service principal pattern (e.g., `${SERVICE}@${HOST}.${SERVICE}`
+- Presto coordinator Kerberos service principal pattern (e.g., `${SERVICE}@${HOST}.${SERVICE}`)
### Additional JDBC connection string options
diff --git a/docs/databases/danger-zone.md b/docs/databases/danger-zone.md
index 36f66249c7d..f4ea3b81d55 100644
--- a/docs/databases/danger-zone.md
+++ b/docs/databases/danger-zone.md
@@ -25,6 +25,6 @@ This option allows you to clear all saved field values that were collected durin
> If you’re trying to migrate from a development DB to a production one, you don’t need to do this. You can just
> edit your connection details.
-This will delete the database _connection_ (not your database and its data). But deleting the connection will also delete all of the questions, models, metrics, segments. You'll have to check a bunch of boxes to even do this to make you know what you're doing.
+This will delete the database _connection_ (not your database and its data). But deleting the connection will also delete all of the questions, models, metrics, segments. You'll have to check a bunch of boxes to even do this to make sure you know what you're doing.
This action is irreversible in Metabase. If you accidentally delete a database connection, the only way to get your stuff back is to restore your Metabase from the last [backup of your application database](../installation-and-operation/backing-up-metabase-application-data.md).
diff --git a/docs/databases/encrypting-details-at-rest.md b/docs/databases/encrypting-details-at-rest.md
index befce176978..741bdcebd2c 100644
--- a/docs/databases/encrypting-details-at-rest.md
+++ b/docs/databases/encrypting-details-at-rest.md
@@ -12,7 +12,7 @@ Metabase stores connection information for the various databases you add in the
1. Generate a secret key that is at least 16 characters (longer is even better!). We recommend using a secure random key generator, such as `openssl`.
> You cannot decrypt connection details without this key. If you lose (or change) the key, you'll have to reset all of the connection details that have been encrypted with that key in the Admin Panel.
-2. Set your secret key as the environment variable `MB_ENCRYPTION_SECRET_KEY`. On self-hosted [Pro and Enterprise plans](https://www.metabase.com/pricing/) plans, you can set also set this using the [config file](../configuring-metabase/config-file.md).
+2. Set your secret key as the environment variable `MB_ENCRYPTION_SECRET_KEY`. On self-hosted [Pro and Enterprise plans](https://www.metabase.com/pricing/) plans, you can also set this using the [config file](../configuring-metabase/config-file.md).
### Example commands for creating and adding a key
diff --git a/docs/databases/ssh-tunnel.md b/docs/databases/ssh-tunnel.md
index 839a8d43b4c..0cec2b4a2fd 100644
--- a/docs/databases/ssh-tunnel.md
+++ b/docs/databases/ssh-tunnel.md
@@ -21,7 +21,7 @@ Sometimes when a data warehouse is inside an enterprise environment, direct conn
## How to use SSH tunneling
-When connecting though a bastion host:
+When connecting through a bastion host:
- Answer yes to the "Use an SSH-tunnel for database connections" parameter.
- Enter the hostname for the data warehouse as it is seen from inside the network in the `Host` parameter.
@@ -50,8 +50,8 @@ ssh <SSH tunnel username>@<SSH tunnel host> -p <SSH tunnel port>
Another common case where direct connections are impossible is when connecting to a data warehouse that is only accessible locally and does not allow remote connections. In this case you will be opening an SSH connection to the data warehouse, then from there connecting back to the same computer.
- Answer yes to the "Use an SSH-tunnel for database connections" parameter.
-- Enter `localhost` in the `Host` parameter. This is the name the server.
-- Enter the same value in the `Port` parameter that you would use if you where sitting directly at the data warehouse host system.
+- Enter `localhost` in the `Host` parameter. This is the name of the server.
+- Enter the same value in the `Port` parameter that you would use if you were sitting directly at the data warehouse host system.
- Enter the external name of the data warehouse, as seen from the outside of the network (or wherever you are) into the `SSH tunnel host` parameter.
- Enter the SSH port as seen from outside the network into the `SSH tunnel port` parameter. This is usually 22, regardless of which data warehouse you are connecting to.
- Choose your authentication method as described above (username and password or SSH key).
diff --git a/docs/databases/users-roles-privileges.md b/docs/databases/users-roles-privileges.md
index 7870a668bee..fc6e374c581 100644
--- a/docs/databases/users-roles-privileges.md
+++ b/docs/databases/users-roles-privileges.md
@@ -98,7 +98,7 @@ This is a good option if you're connecting to a local database for development o
Both [actions](../actions/introduction.md) and the [editable table data](../data-modeling/editable-tables.md) let Metabase write back to specific tables in your database.
-if you're using actions or editable tables, then in addition to the [minimum database privileges](#minimum-database-privileges), you'll need to grant write access to any tables you want to be able to write to.
+If you're using actions or editable tables, then in addition to the [minimum database privileges](#minimum-database-privileges), you'll need to grant write access to any tables you want to be able to write to.
- Create a new role called `metabase_writer`.
- Give the role `INSERT`, `UPDATE`, and `DELETE` privileges to the relevant tables.
diff --git a/docs/developers-guide/build.md b/docs/developers-guide/build.md
index 4d4071dee95..30a5f71d9fb 100644
--- a/docs/developers-guide/build.md
+++ b/docs/developers-guide/build.md
@@ -104,7 +104,7 @@ The “official” branch of Metabase is called `master`, and other feature deve
git pull
```
- You should do this every time to make sure that you have all the latest Metabase branches and code on your computer. It’s also how you’ll get updates on a feature branch someone make changes to it.
+ You should do this every time to make sure that you have all the latest Metabase branches and code on your computer. It’s also how you’ll get updates on a feature branch when someone makes changes to it.
7. Find the name of the branch you want to run by going to the “pull request” page for that feature on GitHub and copying the branch name from there. Here’s [an example PR page](https://github.com/metabase/metabase/pull/19138), with the branch name
`fix-native-dataset-drill-popover`.
diff --git a/docs/developers-guide/docs.md b/docs/developers-guide/docs.md
index af0df368b05..69e7a09c86b 100644
--- a/docs/developers-guide/docs.md
+++ b/docs/developers-guide/docs.md
@@ -14,7 +14,7 @@ You can check for broken links in the [docs](../) directory by running:
bun run docs-lint-links
```
-This command uses [Markdown link check](https://github.com/tcort/markdown-link-check) to vet links in all of the markdown files in the [docs](../) directory. We recommend writing the command's output to a file. E.links.,
+This command uses [Markdown link check](https://github.com/tcort/markdown-link-check) to vet links in all of the markdown files in the [docs](../) directory. We recommend writing the command's output to a file. E.g.,
```
touch ~/links-to-fix.txt && bun run docs-lint-links > ~/links-to-fix.txt
diff --git a/docs/developers-guide/drivers/driver-tests.md b/docs/developers-guide/drivers/driver-tests.md
index 0bfb7134ce0..b3286a1afbc 100644
--- a/docs/developers-guide/drivers/driver-tests.md
+++ b/docs/developers-guide/drivers/driver-tests.md
@@ -23,7 +23,7 @@ Test extensions do things like create new databases and load data for given _dat
To run the test suite with your driver, you'll need to write a series of method implementations for special _test extension_ multimethods. Test extensions do things like create new databases and load data for _database definitions_.
-These test extensions will tell Metabase how to create new databases and load them with test data, and provide information about what Metabae can expect from the created database. Test extensions are simply additional multimethods used only by tests. Like the core driver multimethods, they dispatch on the driver name as a keyword, e.g. `:mysql`.
+These test extensions will tell Metabase how to create new databases and load them with test data, and provide information about what Metabase can expect from the created database. Test extensions are simply additional multimethods used only by tests. Like the core driver multimethods, they dispatch on the driver name as a keyword, e.g. `:mysql`.
## File organization
@@ -80,7 +80,7 @@ You only need one call -- there's no need to do all three for a `:sql-jdbc` driv
## Anatomy of a Metabase test
-Let's look at an real-life Metabase test so we can understand how it works and what exactly we need to do to power it:
+Let's look at a real-life Metabase test so we can understand how it works and what exactly we need to do to power it:
```clj
;; expect-with-non-timeseries-dbs = run against all drivers listed in `DRIVERS` env var except timeseries ones like Druid
@@ -121,9 +121,9 @@ That's about as much as you'd need to know about the internals of how Metabase t
## Loading Data
-In order to ensure consistent behavior across different drivers, the Metabase test suite creates new databases and load datas into them from a set of shared _Database Definitions_. That means whether we're running a test against MySQL, Postgres, SQL Server, or MongoDB, a single test can check that we get the exact same results for every driver!
+In order to ensure consistent behavior across different drivers, the Metabase test suite creates new databases and loads data into them from a set of shared _Database Definitions_. That means whether we're running a test against MySQL, Postgres, SQL Server, or MongoDB, a single test can check that we get the exact same results for every driver!
-Most of these database definitions live in [EDN](https://github.com/edn-format/edn) files; the majority of tests run against a test database named "test data", whose definition can be found [here](https://github.com/metabase/metabase/blob/master/test/metabase/test/data/dataset_definitions/test-data.edn). Take a look at that file -- it's just a simple set of tables names, column names and types, and then a few thousand rows of data to load into those tables.
+Most of these database definitions live in [EDN](https://github.com/edn-format/edn) files; the majority of tests run against a test database named "test data", whose definition can be found [here](https://github.com/metabase/metabase/blob/master/test/metabase/test/data/dataset_definitions/test-data.edn). Take a look at that file -- it's just a simple set of table names, column names and types, and then a few thousand rows of data to load into those tables.
Like test extension method definitions, schemas for `DatabaseDefinition` live in [`metabase.test.data.interface`](https://github.com/metabase/metabase/blob/master/test/metabase/test/data/interface.clj) -- you can take a look and see exactly what a database definition is supposed to look like.
diff --git a/docs/developers-guide/internationalization.md b/docs/developers-guide/internationalization.md
index 57644810de2..c46c9678cef 100644
--- a/docs/developers-guide/internationalization.md
+++ b/docs/developers-guide/internationalization.md
@@ -75,6 +75,6 @@ eg,
Every string language needs an escape character. Since `{0}` is an argument to be spliced in, how would you put a literal "{0}" in the string. The apostrophe serves this role and is described in the MessageFormat [javadocs](https://docs.oracle.com/javase/7/docs/api/java/text/MessageFormat.html).
-These is an unfortunate side effect of this though. Since the apostrophe is such a commeon part of speech (especially in french), we often can end up with escape characters used as a regular part of a string rather than the escape character. Format strings need to use double apostrophes like `(deferred-tru "SAML attribute for the user''s email address")` to escape the apostrophe.
+This is an unfortunate side effect of this though. Since the apostrophe is such a common part of speech (especially in french), we often can end up with escape characters used as a regular part of a string rather than the escape character. Format strings need to use double apostrophes like `(deferred-tru "SAML attribute for the user''s email address")` to escape the apostrophe.
-There are lots of translated strings in French that use a single apostrophe incorrectly. (eg "l'URL" instead of "l''URL"). We have a manual fix to this in `bin/i18n/src/i18n/create_artifacts/backend.clj` where we try to identify these apostrophes which are not escape characters and replace them with a double quote.
+There are lots of translated strings in French that use a single apostrophe incorrectly. (eg "l'URL" instead of "l''URL"). We have a manual fix to this in `bin/i18n/src/i18n/create_artifacts/backend.clj` where we try to identify these apostrophes which are not escape characters and replace them with a double apostrophe.
diff --git a/docs/embedding/full-app-embedding-quick-start-guide.md b/docs/embedding/full-app-embedding-quick-start-guide.md
index 5cd43abcea9..81edacb24b6 100644
--- a/docs/embedding/full-app-embedding-quick-start-guide.md
+++ b/docs/embedding/full-app-embedding-quick-start-guide.md
@@ -73,7 +73,7 @@ We'll set up group synchronization later, but for now, be sure to click the **Sa
Here you'll need to input some values for your SSO to work.
-You'll want to declare up two constants in your app:
+You'll want to declare up to two constants in your app:
- `METABASE_JWT_SHARED_SECRET`, paste the JWT signing key that you got from your Metabase here.
- `METABASE_SITE_URL`, which points to your Metabase instance's root path.
diff --git a/docs/embedding/full-app-ui-components.md b/docs/embedding/full-app-ui-components.md
index 66ebc82571f..6ae0bcfdf68 100644
--- a/docs/embedding/full-app-ui-components.md
+++ b/docs/embedding/full-app-ui-components.md
@@ -77,7 +77,7 @@ header=false&additional_info=false
## `breadcrumbs`
-Shown by default in the top nav bar. Collection breadcrumbs show the path to the item (i.e., the collection(s) the item is in). This does not effect Data breadcrumbs if the user has Query Builder permissions. To hide the breadcrumbs:
+Shown by default in the top nav bar. Collection breadcrumbs show the path to the item (i.e., the collection(s) the item is in). This does not affect Data breadcrumbs if the user has Query Builder permissions. To hide the breadcrumbs:
```
breadcrumbs=false
diff --git a/docs/embedding/sdk/collections.md b/docs/embedding/sdk/collections.md
index fb48c55061f..2bf67d556e8 100644
--- a/docs/embedding/sdk/collections.md
+++ b/docs/embedding/sdk/collections.md
@@ -30,7 +30,7 @@ You can embed Metabase's collection browser so that people can explore items in
## Hide the collection picker and hard code the collection you want people to save stuff to
-With static questions, you set a specific collection as the collection people can save items to, so that they don't have bother picking a collection. To hard-code a collection:
+With static questions, you set a specific collection as the collection people can save items to, so that they don't have to bother picking a collection. To hard-code a collection:
1. Set `isSaveEnabled` to true.
2. Set `targetCollection` to the collection ID you want people to save items to.
diff --git a/docs/embedding/sdk/dashboards.md b/docs/embedding/sdk/dashboards.md
index b22661c7527..67e9228f870 100644
--- a/docs/embedding/sdk/dashboards.md
+++ b/docs/embedding/sdk/dashboards.md
@@ -13,7 +13,7 @@ You can embed an interactive, editable, or static dashboard.
## Embedding a dashboard
-You can embed a dashboard using the one of the dashboard components:
+You can embed a dashboard using one of the dashboard components:
### `StaticDashboard`
diff --git a/docs/embedding/sdk/plugins.md b/docs/embedding/sdk/plugins.md
index 6ab4dea1915..9737cf163f4 100644
--- a/docs/embedding/sdk/plugins.md
+++ b/docs/embedding/sdk/plugins.md
@@ -36,7 +36,7 @@ See docs for specific components:
### `mapQuestionClickActions`
-The plugin `mapQuestionClickActions` lets you to customize what happens when people click on a data point on a dashboard or chart. `mapQuestionClickActions` can be used globally, or on component level.
+The plugin `mapQuestionClickActions` lets you customize what happens when people click on a data point on a dashboard or chart. `mapQuestionClickActions` can be used globally, or on component level.
See [`mapQuestionClickActions` plugin](./questions.md#mapquestionclickactions) for more information and examples.
diff --git a/docs/embedding/sdk/questions.md b/docs/embedding/sdk/questions.md
index e3f2b10e2e6..ebc679d533f 100644
--- a/docs/embedding/sdk/questions.md
+++ b/docs/embedding/sdk/questions.md
@@ -14,7 +14,7 @@ There are different ways you can embed questions:
## Embedding a question
-You can embed a question using the one of the question components:
+You can embed a question using one of the question components:
### `StaticQuestion`
diff --git a/docs/embedding/translations.md b/docs/embedding/translations.md
index e85c794343f..d7e32585c29 100644
--- a/docs/embedding/translations.md
+++ b/docs/embedding/translations.md
@@ -75,7 +75,7 @@ Metabase uses these dictionaries to translate user-generated content, like dashb
| pt-BR | Vendor | Vendedor |
| IT | Examples | Esempi |
-Prefer hyphens in your `pt-BR` in your translation dictionary. Underscores are also acceptable (if you download the dictionary _after_ uploading it, Metabase will transform `pt-BR` to `pt_BR`), but since the `locale` parameter in modular embeds only accepts locales with hyphens (like `pt-BR`), we recommend using hyphens for consistency.
+Prefer hyphens in your `pt-BR` translation dictionary. Underscores are also acceptable (if you download the dictionary _after_ uploading it, Metabase will transform `pt-BR` to `pt_BR`), but since the `locale` parameter in modular embeds only accepts locales with hyphens (like `pt-BR`), we recommend using hyphens for consistency.
[See a list of supported locales](../configuring-metabase/localization.md#supported-languages).
diff --git a/docs/people-and-groups/changing-password-complexity.md b/docs/people-and-groups/changing-password-complexity.md
index 398062af1b0..7895ac98edf 100644
--- a/docs/people-and-groups/changing-password-complexity.md
+++ b/docs/people-and-groups/changing-password-complexity.md
@@ -15,7 +15,7 @@ Metabase offers a couple controls for administrators who prefer to increase the
export MB_PASSWORD_COMPLEXITY=strong
export MB_PASSWORD_LENGTH=10
-The settings above can be used independently, so it's fine to use only one or the other. By default Metabase use complexity = `normal` and a password length of 6. The following options are available for complexity choice:
+The settings above can be used independently, so it's fine to use only one or the other. By default Metabase uses complexity = `normal` and a password length of 6. The following options are available for complexity choice:
- `weak` = no character constraints
- `normal` = at least 1 digit
diff --git a/docs/people-and-groups/saml-azure.md b/docs/people-and-groups/saml-azure.md
index f9a6444babe..a385db42aa0 100644
--- a/docs/people-and-groups/saml-azure.md
+++ b/docs/people-and-groups/saml-azure.md
@@ -64,9 +64,9 @@ If you want to send the user group membership to Metabase, then you need to add
1. To the right of "Attributes & Claims", click on "Edit."
2. Click "Add a group claim."
- 3 On the menu that appears for "Which groups associated with the user should be returned in the claim?", select "All groups."
-3. Click on Save.
-4. Then add the group mapping on the Metabase SAML configuration.
+3. On the menu that appears for "Which groups associated with the user should be returned in the claim?", select "All groups."
+4. Click on Save.
+5. Then add the group mapping on the Metabase SAML configuration.
## Further reading
diff --git a/docs/people-and-groups/saml-keycloak.md b/docs/people-and-groups/saml-keycloak.md
index 48af55cdfad..dd7c014d2b6 100644
--- a/docs/people-and-groups/saml-keycloak.md
+++ b/docs/people-and-groups/saml-keycloak.md
@@ -91,9 +91,9 @@ In your Keycloak client:
2. In SAML settings, toggle on **Synchronize Group Memberships**
3. For each of the Keycloak groups, set up a new mapping to a Metabase group.
- Currently, Keycloak groups will show up in Metabase with the slash character ("/") prepended to the group name. So, for example, a group named `sales` in Keycloak show up in Metabase as `/sales`.
+ Currently, Keycloak groups will show up in Metabase with the slash character ("/") prepended to the group name. So, for example, a group named `sales` in Keycloak shows up in Metabase as `/sales`.
-4. In **Group attribute name**, enter `member_of` (the name for the attribute with the group list in your Keycloack configuration).
+4. In **Group attribute name**, enter `member_of` (the name for the attribute with the group list in your Keycloak configuration).
## Troubleshooting SAML issues
diff --git a/docs/people-and-groups/saml-okta.md b/docs/people-and-groups/saml-okta.md
index b11e30c9cbd..853090b906e 100644
--- a/docs/people-and-groups/saml-okta.md
+++ b/docs/people-and-groups/saml-okta.md
@@ -59,7 +59,7 @@ Even though Okta says these are optional, Metabase requires them. Okta will pass
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname` | user.firstName |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname` | user.lastName |
-The names of attribute statement in Okta should match the attribute names in Metabase (names are case sensitive). If you want to use non-default attribute names in you Okta app configuration, you will also need to change the names for the attribute fields in Metabase in **Admin panel** > **Authentication** > **SAML**.
+The names of attribute statements in Okta should match the attribute names in Metabase (names are case sensitive). If you want to use non-default attribute names in your Okta app configuration, you will also need to change the names for the attribute fields in Metabase in **Admin panel** > **Authentication** > **SAML**.
> **Make sure that people [cannot edit their email address attribute](https://help.okta.com/oie/en-us/content/topics/users-groups-profiles/usgp-user-edit-attributes.htm)**. To log people in to your Metabase (or to create a Metabase account on first login), your IdP will pass the email address attribute to Metabase. If a person can change the email address attribute, they'll potentially be able to access Metabase accounts other than their own.
diff --git a/docs/questions/native-editor/basic-sql-parameters.md b/docs/questions/native-editor/basic-sql-parameters.md
index b292f3d89f4..3139f8bbccc 100644
--- a/docs/questions/native-editor/basic-sql-parameters.md
+++ b/docs/questions/native-editor/basic-sql-parameters.md
@@ -24,7 +24,7 @@ WHERE
{% endraw %}
```
-These basic variabless simply plug in the values set by the widget into the placeholder in the code. Basic variables have a different syntax than [field filters](./sql-parameters.md).
+These basic variables simply plug in the values set by the widget into the placeholder in the code. Basic variables have a different syntax than [field filters](./sql-parameters.md).
Here's the [field filter](./field-filters.md) syntax:
diff --git a/docs/questions/native-editor/field-filters.md b/docs/questions/native-editor/field-filters.md
index 48342b35aa4..bfd6d3b2cbf 100644
--- a/docs/questions/native-editor/field-filters.md
+++ b/docs/questions/native-editor/field-filters.md
@@ -99,7 +99,7 @@ WHERE
{% endraw %}
```
-Here, we again map the field filter to the`category` field in the `products` table. But since we use a CTE, aliased as `expensive_products`, we'd need to put `expensive_products.category` in the **Table and field alias** input for the mapping to work correctly.
+Here, we again map the field filter to the `category` field in the `products` table. But since we use a CTE, aliased as `expensive_products`, we'd need to put `expensive_products.category` in the **Table and field alias** input for the mapping to work correctly.
## Field filters must be connected to database fields included in the query
diff --git a/docs/questions/native-editor/snippets.md b/docs/questions/native-editor/snippets.md
index ee86b544fa7..e8a6fc99dab 100644
--- a/docs/questions/native-editor/snippets.md
+++ b/docs/questions/native-editor/snippets.md
@@ -45,7 +45,7 @@ In the [**native editor**](./writing-sql.md):
You can also create a new snippet from the Snippet sidebar:
-1. Open the native editor by clicking **+ New > SQL query** or **+ New > Native query**in the top right corner.
+1. Open the native editor by clicking **+ New > SQL query** or **+ New > Native query** in the top right corner.
2. Open the Snippet sidebar by clicking the **Snippets** button above the editor window
3. Enter the code that you want to save as a reusable snippet.
4. Save.
diff --git a/docs/questions/native-editor/writing-sql.md b/docs/questions/native-editor/writing-sql.md
index 75f91419138..9ae0bb53387 100644
--- a/docs/questions/native-editor/writing-sql.md
+++ b/docs/questions/native-editor/writing-sql.md
@@ -116,7 +116,7 @@ On saved SQL questions without [parameters](./sql-parameters.md), you'll get the
![Explore results button](../images/explore-results.png)
-## Drill-though in SQL questions
+## Drill-through in SQL questions
Visualizations created with SQL have limited [drill-through][drill-through] capabilities:
diff --git a/docs/questions/query-builder/expressions-list.md b/docs/questions/query-builder/expressions-list.md
index c7fe28ba4b8..f782b1bc1dc 100644
--- a/docs/questions/query-builder/expressions-list.md
+++ b/docs/questions/query-builder/expressions-list.md
@@ -1046,7 +1046,7 @@ Example: `Offset(Sum([Total]), -1)` would get the `Sum([Total])` value from the
## Database limitations
-Limitations are noted for each aggregation and function above, and here there are in summary:
+Limitations are noted for each aggregation and function above, and here they are in summary:
**H2** (including Metabase Sample Database): `Median`, `Percentile`, `convertTimezone`, `regexExtract`, `datetime`, `float`, `splitPart`.
diff --git a/docs/questions/query-builder/expressions/datetimeadd.md b/docs/questions/query-builder/expressions/datetimeadd.md
index ec9da1dfb0a..b218f38bdb5 100644
--- a/docs/questions/query-builder/expressions/datetimeadd.md
+++ b/docs/questions/query-builder/expressions/datetimeadd.md
@@ -33,7 +33,7 @@ title: DatetimeAdd
`amount`:
- An integer. You cannot use fractional values. For example, you cannot add "half a year" (0.5).
-- May be a negative number: `datetimeAdd("2021-03-25", -1, "month")` will return `2021-04-25`.
+- May be a negative number: `datetimeAdd("2021-03-25", -1, "month")` will return `2021-02-25`.
## Calculating an end date
diff --git a/docs/questions/query-builder/expressions/isempty.md b/docs/questions/query-builder/expressions/isempty.md
index 7147606423b..de5b323c16d 100644
--- a/docs/questions/query-builder/expressions/isempty.md
+++ b/docs/questions/query-builder/expressions/isempty.md
@@ -39,7 +39,7 @@ case(isEmpty([Feedback]), true, false)
You can combine `isEmpty` with the [`case` expression](./case.md) to replace empty strings with something more descriptive.
-For example, you can create a new custom column that will contain `"No feedback"` when the original `[Feedback]` column is empty or null, and the feedback value when `[Feedback]` is has a non-empty value. The custom expression to do it is:
+For example, you can create a new custom column that will contain `"No feedback"` when the original `[Feedback]` column is empty or null, and the feedback value when `[Feedback]` has a non-empty value. The custom expression to do it is:
```
case(isEmpty([Feedback]), "No feedback.", [Feedback])
diff --git a/docs/questions/query-builder/summarizing-and-grouping.md b/docs/questions/query-builder/summarizing-and-grouping.md
index 8ac5d831ea7..b202cd1d902 100644
--- a/docs/questions/query-builder/summarizing-and-grouping.md
+++ b/docs/questions/query-builder/summarizing-and-grouping.md
@@ -32,7 +32,7 @@ Adding a summarize step lets you choose how to aggregate the data from the previ
Basic metrics include:
-- **Count of rows:** the total of number of rows in the table, after any filters have been applied. If you're looking at your `Orders` table and want to know how many orders were placed with a price greater than \$40, you’d filter by “Price greater than 40,” and then select `Count of rows`, because you want Metabase to count how many orders matched your filter.
+- **Count of rows:** the total number of rows in the table, after any filters have been applied. If you're looking at your `Orders` table and want to know how many orders were placed with a price greater than \$40, you’d filter by “Price greater than 40,” and then select `Count of rows`, because you want Metabase to count how many orders matched your filter.
- **Sum of …:** the sum of all the values in a specific column.
- **Average of …:** the average of all the values in a single column.
- **Number of distinct values of…:** the number of unique values in all the cells of a single column. This is useful when trying to find out things like how many different _types_ of products were sold last month (not how many were sold in total).
diff --git a/docs/questions/visualizations/gauge.md b/docs/questions/visualizations/gauge.md
index c673b87718b..9490107c265 100644
--- a/docs/questions/visualizations/gauge.md
+++ b/docs/questions/visualizations/gauge.md
@@ -41,7 +41,7 @@ To build a gauge chart, you'll need:
You can set the ranges, their colors, and optional labels in chart settings.
-To open the chart setting, click on the **Visualization** icon at the bottom left of the screen.
+To open the chart settings, click on the **Visualization** icon at the bottom left of the screen.
Format options will apply to both the result of the query and the range boundaries:
diff --git a/docs/questions/visualizations/line-bar-and-area-charts.md b/docs/questions/visualizations/line-bar-and-area-charts.md
index 7f7975d769d..19e30b22164 100644
--- a/docs/questions/visualizations/line-bar-and-area-charts.md
+++ b/docs/questions/visualizations/line-bar-and-area-charts.md
@@ -52,7 +52,7 @@ These three charting types have similar options, which are broken up into the fo
## Data settings
-Here you can configure settings for the how the data is displayed.
+Here you can configure settings for how the data is displayed.
For each series on the chart, you can:
@@ -94,7 +94,7 @@ Here you set things like:
![Goal line on chart](../images/goal-line.png)
-Goal lines can be used in conjunction with [alerts](../alerts.md) to send an email or a Slack message when your metric cross this line.
+Goal lines can be used in conjunction with [alerts](../alerts.md) to send an email or a Slack message when your metric crosses this line.
### Trend lines
@@ -104,7 +104,7 @@ Goal lines can be used in conjunction with [alerts](../alerts.md) to send an ema
### Stacked bar chart
-If you have multiple series, you can stack them on bar chart.
+If you have multiple series, you can stack them on a bar chart.
![Stacked bar chart](../images/stacked-bar-chart.png)
@@ -154,7 +154,7 @@ Here you'll find additional settings for configuring your x and y axes (as in ax
- Show label (the label for the axis).
- Rename the axis
- Split y-axis when necessary
-- Auto y-axis range. When not toggled on, you can set the y-axis range (it's min and max values).
+- Auto y-axis range. When not toggled on, you can set the y-axis range (its min and max values).
- Scale: Linear, power, or log.
- Show lines and marks
- Unpin from zero. Allows you to "Zoom in" on charts with values well above zero. Here's an example (note the y-axis starts at 20,000):
@@ -162,7 +162,7 @@ Here you'll find additional settings for configuring your x and y axes (as in ax
## Chart legend
-For charts with multiple series or breakouts, chart legend displays the label and color of each series.
+For charts with multiple series or breakouts, the chart legend displays the label and color of each series.
![Legend](../images/legend.png)
diff --git a/docs/questions/visualizations/numbers.md b/docs/questions/visualizations/numbers.md
index f5535868106..a488d53ba94 100644
--- a/docs/questions/visualizations/numbers.md
+++ b/docs/questions/visualizations/numbers.md
@@ -29,7 +29,7 @@ To create a number chart, you need a query that returns a single record with at
![Number type](../images/number-type.png)
-4. If your query returns multiple values, you might need to manually select which value to display as the big number. Open visualization setting by clicking on the **gear** button in the bottom left, and select the **Field to show** in the **Formatting** settings.
+4. If your query returns multiple values, you might need to manually select which value to display as the big number. Open visualization settings by clicking on the **gear** button in the bottom left, and select the **Field to show** in the **Formatting** settings.
## Number chart settings
diff --git a/docs/questions/visualizations/progress-bar.md b/docs/questions/visualizations/progress-bar.md
index 9a4de417f53..56fd76d7dfa 100644
--- a/docs/questions/visualizations/progress-bar.md
+++ b/docs/questions/visualizations/progress-bar.md
@@ -34,7 +34,7 @@ To create a progress bar you'll need:
## Create a progress bar
-Once you built the query that returns data in the appropriate shape, you can create a progress bar:
+Once you've built the query that returns data in the appropriate shape, you can create a progress bar:
1. Visualize the query results.
diff --git a/docs/questions/visualizations/sankey.md b/docs/questions/visualizations/sankey.md
index aaabfda1a12..3d8bcf542fa 100644
--- a/docs/questions/visualizations/sankey.md
+++ b/docs/questions/visualizations/sankey.md
@@ -58,7 +58,7 @@ Your data can include more than three columns, but each row must include the req
## Sankey display options
-You can change a charts alignment, edge labels, and edge colors.
+You can change a chart's alignment, edge labels, and edge colors.
### Alignment
diff --git a/docs/questions/visualizations/table.md b/docs/questions/visualizations/table.md
index 7e0b064ea94..f3e7e51c7ef 100644
--- a/docs/questions/visualizations/table.md
+++ b/docs/questions/visualizations/table.md
@@ -308,7 +308,7 @@ When you add a table to a dashboard, you can add [custom destinations](../../das
## Table pagination on dashboard cards
-When you add a table to dashboard, the table will be scrollable by default. You can paginate the rows by:
+When you add a table to a dashboard, the table will be scrollable by default. You can paginate the rows by:
1. Clicking on the **Pencil** icon to edit the dashboard.
2. Hovering over the dashcard containing the table, and clicking the **Visualization** icon.