update README

Author: nllho

README.md

@@ -12,7 +12,7 @@ Here's a simple Metabase dashboard in action:
 
 Embedding Metabase charts will always be free, but we include a "Powered by Metabase" graphic when using the open source version.
 
-If you'd like to remove the "Powered by Metabase" attribution, check out our [Enterprise Edition](https://www.metabase.com/enterprise/). With full app embedding, you can add dashboards, charts, or even the entire Metabase interface into your own app with a fully branded experience.
+If you'd like to remove the "Powered by Metabase" attribution, check out our [paid plans](https://www.metabase.com/pricing/). With [full-app embedding](#full-app-embedding), you can add dashboards, charts, or even the entire Metabase interface into your own app with a fully branded experience.
 
 ## Prerequisites
 
@@ -22,13 +22,26 @@ If you'd like to remove the "Powered by Metabase" attribution, check out our [En
 
 We'll first need to set up a running instance of Metabase to serve the embedded dashboards.
 
-1. If you already have an instance of Metabase running on your machine, shut it down. Then download and run Metabase according to the guides in our [install section](https://www.metabase.com/docs/latest/operations-guide/installing-metabase.html).
+1. Shut down Metabase if you already have it running on your machine.
+2. Download the [JAR file for Metabase OSS](https://www.metabase.com/start/oss/jar).
+3. Open up a terminal and clone this repo to your machine.
+4. Move the `metabase.jar` file to the `metabase` directory of this repo.
+5. Run the JAR file:
+    ```
+    java -jar metabase.jar
+    ```
+6. [Run any example](#running-the-apps) depending on the programming language you choose.
 
-2. Open up a terminal and clone this repo to your machine.
+## Enable embedding
 
-3. `cd` into embedding-reference-apps.
+Once you've got Metabase running (on port 3000 by default):
 
-3. Run any example depending on the programming language you choose.
+1. Go to `localhost:3000` in your browser.
+2. Log into Metabase.
+    - User: plucky@admin.com
+    - Password: Metabase123
+3. Go to **Admin settings** > **Embedding** and click the toggle.
+4. Make sure the embedding key in the **Admin settings** matches the embedding key in `index.js`.
 
 ## Running the apps
 
@@ -44,35 +57,27 @@ To see an embedded Metabase dashboard in action, [set up Metabase](#set-up-metab
 
 ## Embedding charts or dashboards
 
-There are two ways to embed charts or dashboards in web applications:
+There are three ways to embed Metabase charts or dashboards in web applications.
 
 ### Public embeds
 
-The Public embedding method is to simply use the public URLs inside of an iframe, or really anywhere you can insert HTML. The embedded dashboard has a secure URL, so a user can only look at the contents of the dashboard being shared. An end user never has information they can use to modify the URL and gain access to any other resources on your Metabase instance.
+The [public embedding](https://www.metabase.com/docs/latest/questions/sharing/public-links#public-embeds) method is to simply use the public URLs inside of an iframe, or really anywhere you can insert HTML. The embedded dashboard has a secure URL, so a user can only look at the contents of the dashboard being shared. An end user never has information they can use to modify the URL and gain access to any other resources on your Metabase instance.
 
 ### Signed embeds
 
-With signed embedding, all embedded charts and dashboards have to be signed using a secret key. This allows you to build dynamic dashboards with a parameter that can be be locked down on the client side.  You should sign embedded charts and dashboards on your server, which allows you to embed dashboards accessible to specific organizations, accounts, or users.
+With [signed embedding](https://www.metabase.com/docs/latest/embedding/signed-embedding), all embedded charts and dashboards have to be signed using a secret key. This allows you to build dynamic dashboards with a [parameter that can be be locked down](https://www.metabase.com/docs/latest/embedding/signed-embedding-parameters#restricting-data-in-a-signed-embed) on the client side.  You should sign embedded charts and dashboards on your server, which allows you to embed dashboards accessible to specific organizations, accounts, or users.
 
 The web applications go into more detail about embedding, and provide examples. Start up the [Node app](/node/README.md) and explore the app.
 
-## Documentation on embeds
+### Full-app embedding
 
-You can also learn more about embedding dashboards by reading [Metabase's documentation](https://www.metabase.com/docs/latest/).
+Full-app embedding puts the entire Metabase app inside your app, so you can include the query builder in addition to your charts and dashboards. Full-app embedding isn't covered in this repo. Check out the [full-app embedding demo](https://embedding-demo.metabase.com/) instead.
 
-- [Quick search: embed](https://www.metabase.com/search.html?query=embed).
+## Docs and articles
 
-Article links:
-
-- [Embedding Metabase components in other applications](https://www.metabase.com/docs/latest/administration-guide/13-embedding.html)
-- [Embedding all of Metabase in your web app](https://www.metabase.com/docs/latest/enterprise-guide/full-app-embedding.html)
-- [Sharing and embedding dashboards or questions](https://www.metabase.com/docs/latest/administration-guide/12-public-links.html)
-
-## Helpful info
-Credentials for Metabase should auto-populate, but here they are for reference:
-
-- user: plucky@admin.com
-- password: Metabase123
+- [Embedding overview](https://www.metabase.com/docs/latest/embedding/introduction)
+- [Publishing data visualizations to the web](https://www.metabase.com/learn/customer-facing-analytics/embedding-charts-and-dashboards)
+- [Public sharing](https://www.metabase.com/docs/latest/questions/sharing/public-links)
 
 ## Run into trouble?