[nightly] release-x.57.x -> release-x.57.x

_docs/latest/embedding/sdk/quickstart-with-sample-app.md

@@ -26,34 +26,59 @@ This guide sets up the embedded analytics SDK with a [sample React app](https://
 - [A Metabase Pro or Enterprise license](/pricing/) (If you don't have a license, check out [this quickstart](./quickstart) that lacks the paid JWT SSO setup.)
 - (Optional): [Docker](https://www.docker.com/)
 
+## Clone the sample app repo
+
+1. Clone the [sample React app](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable).
+
+```bash
+git clone git@github.com:metabase/metabase-nodejs-react-sdk-embedding-sample.git
+```
+
+2. Check out the branch in the [metabase-nodejs-react-sdk-embedding-sample](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable) repo that corresponds to your Metabase version.
+
+```bash
+git checkout {{page.version}}-stable
+```
+
+E.g., if you're running Metabase 1.57 make sure the sample app repo is on the `57-stable` branch. You can find your Metabase version in the Metabase UI by clicking on the gears icon in the upper right and selecting **About Metabase**.
+
 ## Two ways to set up the sample app with Metabase
 
 - [Quick setup with Docker](#quick-setup-with-docker) (includes a sample Metabase)
 - [Walkthrough setup](#walkthrough-setup) (bring your own Metabase, or spin up a new one)
 
 ## Quick setup with Docker
 
-This quick setup will run a Docker container with the sample app and a sample Metabase.
+This setup will run a Docker container with the sample app and a sample Metabase.
+
+1. Copy the environment template file:
+
+   In the cloned directory, run:
+
+```bash
+cp .env.docker.example .env.docker
+```
 
-1. Copy `.env.docker.example` to `.env.docker`.
 2. In the `.env.docker` file, replace `<your_enterprise_token>` with your premium embedding token.
+
 3. In the top-level directory, run:
-   ```bash
-   yarn start
-   ```
+
+```bash
+yarn start
+```
 
 This script will:
 
 - Pull a Metabase Docker image and run it in a container.
-- Set up JWT SSO in Metabase.
-- Build and run the sample application with an embedded interactive question.
+- Set up [JWT SSO in Metabase](../../people-and-groups/authenticating-with-jwt)
+- Build and run the sample application with an embedded question.
 
-The app will start on [http://localhost:4400](http://localhost:4400).
+4. The app will start on [http://localhost:4400](http://localhost:4400).
 
-That's it! You should be [up and running](#at-this-point-you-should-be-up-and-running).
+That's it!
 
 If you want to log in to the sample Metabase this command set up, visit [http://localhost:4300](http://localhost:4300). You can log in with email and password as Rene Descartes:
-
+E
 - email: rene@example.com
 - password: foobarbaz
 
@@ -72,10 +97,9 @@ Here's a quick overview of what you'll be doing:
 
 ### Start up the sample application
 
-5. [Get the sample application](#set-up-the-sample-application).
-6. [Set up the application environment](#set-up-the-application-environment).
-7. [Run the app server](#set-up-the-application-server) to handle authentication with JWT and serve the embedded Metabase components.
-8. [Run the client application](#set-up-the-client-application) that will contain Metabase components built with the SDK.
+5. [Set up the application environment](#set-up-the-application-environment).
+6.. [Run the app server](#set-up-the-application-server) to handle authentication with JWT and serve the embedded Metabase components.
+7. [Run the client application](#set-up-the-client-application) that will contain Metabase components built with the SDK.
 
 And then fiddle around with styling.
 
@@ -85,15 +109,15 @@ Let's go.
 
 You can run Metabase Pro on a Cloud plan with a [free trial](/pricing/).
 
-Or run it locally. Here's a docker one-liner:
+Or run it locally. Here's a [docker](../../installation-and-operation/running-metabase-on-docker) one-liner:
 
-```sh
+```bash
 docker run -d -p 3000:3000 --name metabase metabase/metabase-enterprise:latest
 ```
 
 You can also [download the JAR](https://downloads.metabase.com/enterprise/latest/metabase.jar), and run it like so:
 
-```sh
+```bash
 java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar
 ```
 
@@ -148,26 +172,10 @@ Be sure to hit the **Save and enable** button, or all is void.
 
 ## Set up the sample application
 
-Clone the [Metabase Node JS React SDK embedding sample app](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable).
-
-```sh
-git clone git@github.com:metabase/metabase-nodejs-react-sdk-embedding-sample.git
-```
-
-### Check out the branch that corresponds to your Metabase version
-
-Check out the branch in the [metabase-nodejs-react-sdk-embedding-sample](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable) repo that corresponds to your Metabase version.
-
-E.g., if you're running Metabase 1.53, make sure the sample app repo is on the `53-stable` branch. You can find your Metabase version in the Metabase UI by clicking on the gears icon in the upper right and selecting **About Metabase**.
-
-To switch to another branch, run `git checkout <branch-name>`, e.g.:
-
-```
-git checkout 52-stable
-```
-
 ## Set up the application environment
 
+[Clone the sample app](#clone-the-sample-app-repo) and `cd` into it.
+
 In the sample app's main directory, copy the `.env.example` template to `.env`.
 
 ```sh
@@ -233,7 +241,7 @@ Start the client app:
 npm start
 ```
 
-Your browser should automatically open the app. By default, the app runs on [http://localhost:3100](localhost:3100).
+Your browser should automatically open the app. By default, the app runs on [http://localhost:3100](http://localhost:3100).
 
 ## At this point, you should be up and running
 

_docs/v0.57/embedding/sdk/quickstart-with-sample-app.md

@@ -24,34 +24,59 @@ This guide sets up the embedded analytics SDK with a [sample React app](https://
 - [A Metabase Pro or Enterprise license](/pricing/) (If you don't have a license, check out [this quickstart](./quickstart) that lacks the paid JWT SSO setup.)
 - (Optional): [Docker](https://www.docker.com/)
 
+## Clone the sample app repo
+
+1. Clone the [sample React app](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable).
+
+```bash
+git clone git@github.com:metabase/metabase-nodejs-react-sdk-embedding-sample.git
+```
+
+2. Check out the branch in the [metabase-nodejs-react-sdk-embedding-sample](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable) repo that corresponds to your Metabase version.
+
+```bash
+git checkout {{page.version}}-stable
+```
+
+E.g., if you're running Metabase 1.57 make sure the sample app repo is on the `57-stable` branch. You can find your Metabase version in the Metabase UI by clicking on the gears icon in the upper right and selecting **About Metabase**.
+
 ## Two ways to set up the sample app with Metabase
 
 - [Quick setup with Docker](#quick-setup-with-docker) (includes a sample Metabase)
 - [Walkthrough setup](#walkthrough-setup) (bring your own Metabase, or spin up a new one)
 
 ## Quick setup with Docker
 
-This quick setup will run a Docker container with the sample app and a sample Metabase.
+This setup will run a Docker container with the sample app and a sample Metabase.
+
+1. Copy the environment template file:
+
+   In the cloned directory, run:
+
+```bash
+cp .env.docker.example .env.docker
+```
 
-1. Copy `.env.docker.example` to `.env.docker`.
 2. In the `.env.docker` file, replace `<your_enterprise_token>` with your premium embedding token.
+
 3. In the top-level directory, run:
-   ```bash
-   yarn start
-   ```
+
+```bash
+yarn start
+```
 
 This script will:
 
 - Pull a Metabase Docker image and run it in a container.
-- Set up JWT SSO in Metabase.
-- Build and run the sample application with an embedded interactive question.
+- Set up [JWT SSO in Metabase](../../people-and-groups/authenticating-with-jwt)
+- Build and run the sample application with an embedded question.
 
-The app will start on [http://localhost:4400](http://localhost:4400).
+4. The app will start on [http://localhost:4400](http://localhost:4400).
 
-That's it! You should be [up and running](#at-this-point-you-should-be-up-and-running).
+That's it!
 
 If you want to log in to the sample Metabase this command set up, visit [http://localhost:4300](http://localhost:4300). You can log in with email and password as Rene Descartes:
-
+E
 - email: rene@example.com
 - password: foobarbaz
 
@@ -70,10 +95,9 @@ Here's a quick overview of what you'll be doing:
 
 ### Start up the sample application
 
-5. [Get the sample application](#set-up-the-sample-application).
-6. [Set up the application environment](#set-up-the-application-environment).
-7. [Run the app server](#set-up-the-application-server) to handle authentication with JWT and serve the embedded Metabase components.
-8. [Run the client application](#set-up-the-client-application) that will contain Metabase components built with the SDK.
+5. [Set up the application environment](#set-up-the-application-environment).
+6.. [Run the app server](#set-up-the-application-server) to handle authentication with JWT and serve the embedded Metabase components.
+7. [Run the client application](#set-up-the-client-application) that will contain Metabase components built with the SDK.
 
 And then fiddle around with styling.
 
@@ -83,15 +107,15 @@ Let's go.
 
 You can run Metabase Pro on a Cloud plan with a [free trial](/pricing/).
 
-Or run it locally. Here's a docker one-liner:
+Or run it locally. Here's a [docker](../../installation-and-operation/running-metabase-on-docker) one-liner:
 
-```sh
+```bash
 docker run -d -p 3000:3000 --name metabase metabase/metabase-enterprise:latest
 ```
 
 You can also [download the JAR](https://downloads.metabase.com/enterprise/latest/metabase.jar), and run it like so:
 
-```sh
+```bash
 java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar
 ```
 
@@ -146,26 +170,10 @@ Be sure to hit the **Save and enable** button, or all is void.
 
 ## Set up the sample application
 
-Clone the [Metabase Node JS React SDK embedding sample app](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable).
-
-```sh
-git clone git@github.com:metabase/metabase-nodejs-react-sdk-embedding-sample.git
-```
-
-### Check out the branch that corresponds to your Metabase version
-
-Check out the branch in the [metabase-nodejs-react-sdk-embedding-sample](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable) repo that corresponds to your Metabase version.
-
-E.g., if you're running Metabase 1.53, make sure the sample app repo is on the `53-stable` branch. You can find your Metabase version in the Metabase UI by clicking on the gears icon in the upper right and selecting **About Metabase**.
-
-To switch to another branch, run `git checkout <branch-name>`, e.g.:
-
-```
-git checkout 52-stable
-```
-
 ## Set up the application environment
 
+[Clone the sample app](#clone-the-sample-app-repo) and `cd` into it.
+
 In the sample app's main directory, copy the `.env.example` template to `.env`.
 
 ```sh
@@ -231,7 +239,7 @@ Start the client app:
 npm start
 ```
 
-Your browser should automatically open the app. By default, the app runs on [http://localhost:3100](localhost:3100).
+Your browser should automatically open the app. By default, the app runs on [http://localhost:3100](http://localhost:3100).
 
 ## At this point, you should be up and running