Merge pull request #2816 from metabase/release-0.18.0

Merge release-0.18.0 into master

.dir-locals.el

@@ -4,6 +4,7 @@
                             (put 'defannotation 'clojure-doc-string-elt 2)
                             (put 'defendpoint 'clojure-doc-string-elt 3)
                             (put 'defsetting 'clojure-doc-string-elt 2)
+                            (put 'setting/defsetting 'clojure-doc-string-elt 2)
 
                             ;; Define custom indentation for functions inside metabase.
                             ;; This list isn't complete; add more forms as we come across them.

docs/users-guide/01-what-is-metabase.md

@@ -3,4 +3,4 @@ Metabase is an open source business intelligence tool. It lets you ask questions
 
 Your questions can be saved for later, making it easy to come back to them, or you can group questions into great looking dashboards. Metabase also makes it easy to share questions and dashboards with the rest of your team. 
 
-To fully understand how to use Metabase, it’s useful to have at least a high level understanding of databases, so we'll discuss [the basics of databases](02-database-basics.md) next.
\ No newline at end of file
+To fully understand how to use Metabase, it’s useful to have at least a high-level understanding of databases, so we'll discuss [the basics of databases](02-database-basics.md) next.

docs/users-guide/02-database-basics.md

 ### A Short Overview of Databases
-Before you jump into working with Metabase, it's helpful to know a few key database terms. 
+Before you jump into working with Metabase, it's helpful to know a few key database terms.
 
 #### Tables
 Fundamentally, databases are *collections of tables*. Tables contain one or more *columns* and one or more *rows*. A row is made up of *cells*, and each cell has a *value* that corresponds to the column it falls under.  
@@ -23,10 +23,10 @@ Columns are also sometimes interchangeably referred to as *fields*. Each field h
 
 * **String Types** (TEXT, CHAR, VCHAR, etc.)  - In the world of technology, snippets of text are referred to as “strings.” (You’ve probably heard of a “string of text” before.) These fields store things like names, addresses, or anything else that is text.
 
-* **Numerical Types** (Integer, Float, DoubleFloat, Decimal, etc.) - These fields store numbers. Integers are whole numbers; Floats and Decimals are ways to store numbers with decimals in them. Numerical types store things like ages, bank account balances, costs, latitudes, and longitudes. 
+* **Numerical Types** (Integer, Float, DoubleFloat, Decimal, etc.) - These fields store numbers. Integers are whole numbers; Floats and Decimals are ways to store numbers with decimals in them. Numerical types store things like ages, bank account balances, costs, latitudes, and longitudes.
 
 * **Time Types** (Timestamp, etc.) - These fields are a special number format used to store dates and times (or both), called “timestamps.” Sometimes databases store an integer timestamp which is either seconds or milliseconds, such as `00:00:00 Coordinated Universal Time (UTC), Thursday, 1 January 1970`. This convention  allows for compact storage of timestamps.
- 
+
 * **IDs** (also called **primary keys**) - This field in a table uniquely identifies each row.  For example, imagine a car reservation app where you can book a car in advance. The ID of the reservation could be the reservation number, and no two reservations would share the same reservation number, allowing each reservation to be uniquely identified by its reservation number.
 
 **Example**
@@ -42,18 +42,18 @@ In the above table, the `Reservation ID` field is the ID (primary key). The `Nam
 
 
 #### Relationships
-Tables can contain references to other tables, which establishes a relationship between them. 
+Tables can contain references to other tables, which establishes a relationship between them.
 
 For example, in our hypothetical car booking app’s database, we could have two tables: one for reservations (let's call it **Reservations**) and one for customers, (we'll call this one **Customers**).  
 
-To connect the reservation data to the corresponding customer data, you can use a *foreign key*.  A foreign key is a special kind of field in a table that references the same column in a different table. Almost always, the field that the foreign key points to is the *ID* or *primary key* in the other table. 
- 
+To connect the reservation data to the corresponding customer data, you can use a *foreign key*.  A foreign key is a special kind of field in a table that references the same column in a different table. Almost always, the field that the foreign key points to is the *ID* or *primary key* in the other table.
+
 For example, in our hypothetical car booking app, we could connect each reservation in the Reservations table to the corresponding customer that made the reservation by having the `Customer` column of the reservation contain the same value as the `ID` column of the customer who made the reservation.
 
 **Reservations**
 
-| Customer | Date | Car | 
-| ---- | --- | --- | 
+| Customer | Date | Car |
+| ---- | --- | --- |
 | 11 | 12/20/2015 | Toyota Camry |
 | 12 | 1/2/2016 | Range Rover |
 
@@ -65,10 +65,13 @@ For example, in our hypothetical car booking app, we could connect each reservat
 | 11| John | 25 |
 | 12| Jenny | 31 |
 
-If we wanted to analyze our hypothetical app's database with Metabase, we could ask a question, like: 
+If we wanted to analyze our hypothetical app's database with Metabase, we could ask a question, like:
 
     What's the average age of all customers who made reservations in February of 2015?
-    
+
 To do this, we’d open up the Reservation table, add a filter to only look at reservations between February 1 and February 28, 2015, select Average for the View. For the Field, now we put our foreign key to use and select Age from the *Customers* table that our Reservations table references — each reservation will now have a corresponding customer age, matched up by the customer ID.
 
-Now that we have a shared vocabulary and a basic understanding of databases, let's learn more about [Asking Questions](03-asking-questions.md)
\ No newline at end of file
+---
+
+## Next: Asking questions
+Now that we have a shared vocabulary and a basic understanding of databases, let's learn more about [asking questions](03-asking-questions.md)

docs/users-guide/03-asking-questions.md

@@ -146,4 +146,7 @@ To try it out, type the command `select sum(subtotal), created_at from orders gr
 
 Questions asked using SQL can be saved, downloaded, or added to a dashboard just like questions asked using the question builder.
 
+---
+
+## Next: Creating charts
 Once you have an answer to your question, you can now learn more about [visualizing answers](04-visualizing-results.md).

docs/users-guide/04-visualizing-results.md

@@ -22,7 +22,10 @@ To change how the answer to your question is displayed, click on the Visualizati
 ![visualizechoices](images/VisualizeChoices.png)
 
 If a particular visualization doesn’t really make sense for your answer, the format option will appear faded in the dropdown menu.  
- 
-Once a question is answered, you can save or download the answer, or add it to a dashboard. 
 
-Learn more about [Sharing Answers](05-sharing-answers.md) next.
\ No newline at end of file
+Once a question is answered, you can save or download the answer, or add it to a dashboard.
+
+---
+
+## Next: Sharing and organizing questions
+Now let's learn about [sharing and organizing your saved questions](05-sharing-answers.md).

docs/users-guide/05-sharing-answers.md

@@ -42,79 +42,7 @@ Sometimes questions outlive their usefulness and need to be sent to Question Hea
 
 If you have second thoughts and want to bring an archived question back, you can see all your archived questions from the **Archive** link at the bottom of the left menu. To unarchive a question, hover over it and click the box icon that appears on the far right.
 
-## Dashboards
 ---
-### What is a dashboard?
-A **dashboard** is a collection of saved questions that you want to refer back to and view regularly. It displays groups of questions and their corresponding answers.
 
-Questions on a dashboard are meant to be viewed together, so they’re usually grouped by some kind of theme or topic, like Users, Inventory, or Reservations. A reservations dashboard could show the number of reservations by day of week, time of day, geographical region, and more.
-
-Have a few key performance indicators that you want to be able to easily check? Make a dashboard featuring questions that show your key metrics and share it with your team.
-
-You can make as many dashboards as you want. Go nuts.
-
-### How to Create a Dashboard
-Once you have a question saved, you can create a dashboard. Click the **Dashboards** dropdown at the top of the screen, then **Create a new dashboard**. Give your new dashboard a name and a description, then click **Create**, and you’ll be taken to your shiny new dashboard. You can always get to your dashboards from the dropdown at the very top of the screen.
-
-![Create Dashboard](images/dashboards/DashboardCreate.png)
-
-### Adding saved questions to a dashboard
-You can add a newly saved question to a dashboard directly from the window that pops up after you save the question, or by clicking the Add to Dashboard icon in the top-right of a question page. You can also go to one of your dashboards and click the plus icon in the top right to add any of your saved questions to the dashboard.
-
-Once you add a question to your dashboard, it’ll look something like this:
-
-![First Dashboard](images/dashboards/FirstDashboard.png)
-
-### Arranging cards
-Each question on a dashboard is in its own card that you can move around or resize as you see fit; just click the edit icon that looks like a pencil in the top-right of the dashboard screen.  
-
-Once you're in edit mode you'll see a grid appear. You can move and resize the cards in the dashboard to your liking and they'll snap to the grid.
-
-![Editing dashboard](images/dashboards/DashboardEdit.png)
-
-- To move cards just click and drag.
-- To resize a card just click and drag the handle at the bottom right corner of the card.
-- To remove a card, click the X icon in the top right corner.
-
-Questions in your dashboard will automatically update their display based on the size you choose to make sure your data looks great at any size.
-
-
-## Deleting a dashboard
-Deleting a dashboard does not delete the individual saved questions on it — it just deletes the dashboard. Remember — dashboards are shared by everyone on your team, so think twice before you delete something that someone else might be using!
-
-To delete a dashboard, click the pencil-looking **Edit** icon in the top right of the dashboard, then click **Delete**.
-
-## Fullscreen dashboards
-
-After you've made your ideal dashboard you may want to put it on a TV or present it in some other visible space to help keep your team up-to-date throughout the day.
-
-To enter fullscreen mode just click the fullscreen icon in the top right of the dashboard.
-
-Once you've entered fullscreen mode you can also switch the dashboard into "Night mode" for higher contrast.
-
-![Night mode](images/dashboards/DashboardNightMode.png)
-
-## Auto refresh
-If your data is more realtime in nature you can set your dashboard up to auto refresh.
-
-![Autorefresh](images/dashboards/DashboardAutorefresh.png)
-
-You can set your dashboard to update in 1, 5, 10, 15, 30, and 60 minute intervals depending on how fresh you need the data to be.
-
-Enabling auto refresh will re-run all the queries on the dashboard at the interval you choose, so keep the size of the dashboard and the complexity of the questions in mind when setting up auto refresh.
-
-Combining fullscreen mode and auto refresh is a great way to keep your team in sync with your data throughout the day.
-
-## Configuring dashboard using URL
-
-It is possible to amend URL of the dashboard to automatically enter fullscreen, enable night mode or autorefresh the dashboard. This allows you to configure the dashboard even when you do not have any input access to the device where dashboard will be displayed, for example, scripted screens.
-
-To configure dashboard using URL address, you can append it with hash keys like `fullscreen`, `night`, or `refresh`. Consider this example:
-
-`https://metabase.mydomain.com/dash/2#refresh=60&fullscreen&night`
-
-This URL will make dashboard enter night mode, fullscreen and refresh every 60 seconds.
-
----
-
-Next, we'll offer up some suggestions on how to create useful dashboards, in our [Tips on Dashboards](06-dashboard-tips.md).
+## Next: Creating dashboards
+Next, we'll learn about [creating dashboards and adding questions to them](06-dashboards.md).

docs/users-guide/06-dashboard-tips.md

-
-## Tips on Creating Helpful Dashboards
-To make a really helpful dashboard, you need to first decide what you want the dashboard to tell you about your data. What questions will give you insight into what you want to know? It helps to think of a topic or theme for your dashboard — something like “customer satisfaction,” or “second quarter sales goals,” for example.
-
-Once you’ve decided what kinds of questions your dashboard is going to answer, create and save your individual questions from the question builder and save them. Next you can add your saved questions to your dashboard and arrange them in a way that makes it easy to scan and understand.
-
-Some tips:
-
-*  Place the most important saved question cards near the top of the dashboard, or make them bigger than the other cards. That’ll help draw people’s attention to what matters most.
-*  If you have more than 10 cards on a dashboard, think about breaking the dashboard into two separate ones. You don't want to overwhelm people with too much information, and each dashboard should revolve around one theme or topic. Remember — you can make as many dashboards as you want, so you don’t have to cram everything into just one.
-
----
-
-## Next: sharing data with Pulses
-Beyond dashboards, another great way to share updates on important metrics is with the [Pulses feature](07-pulses.md).

docs/users-guide/06-dashboards.md

+## Dashboards
+---
+### What is a dashboard?
+A **dashboard** is a collection of saved questions that you want to refer back to and view regularly. It displays groups of questions and their corresponding answers.
+
+Questions on a dashboard are meant to be viewed together, so they’re usually grouped by some kind of theme or topic, like Users, Inventory, or Reservations. A reservations dashboard could show the number of reservations by day of week, time of day, geographical region, and more.
+
+Have a few key performance indicators that you want to be able to easily check? Make a dashboard featuring questions that show your key metrics and share it with your team.
+
+You can make as many dashboards as you want. Go nuts.
+
+### How to Create a Dashboard
+Once you have a question saved, you can create a dashboard. Click the **Dashboards** dropdown at the top of the screen, then **Create a new dashboard**. Give your new dashboard a name and a description, then click **Create**, and you’ll be taken to your shiny new dashboard. You can always get to your dashboards from the dropdown at the very top of the screen.
+
+![Create Dashboard](images/dashboards/DashboardCreate.png)
+
+### Adding saved questions to a dashboard
+You can add a newly saved question to a dashboard directly from the window that pops up after you save the question, or by clicking the Add to Dashboard icon in the top-right of a question page. You can also go to one of your dashboards and click the plus icon in the top right to add any of your saved questions to the dashboard.
+
+Once you add a question to your dashboard, it’ll look something like this:
+
+![First Dashboard](images/dashboards/FirstDashboard.png)
+
+### Arranging cards
+Each question on a dashboard is in its own card that you can move around or resize as you see fit; just click the edit icon that looks like a pencil in the top-right of the dashboard screen.  
+
+Once you're in edit mode you'll see a grid appear. You can move and resize the cards in the dashboard to your liking and they'll snap to the grid.
+
+![Editing dashboard](images/dashboards/DashboardEdit.png)
+
+- To move cards just click and drag.
+- To resize a card just click and drag the handle at the bottom right corner of the card.
+- To remove a card, click the X icon in the top right corner.
+
+Questions in your dashboard will automatically update their display based on the size you choose to make sure your data looks great at any size.
+
+
+### Deleting a dashboard
+Deleting a dashboard does not delete the individual saved questions on it — it just deletes the dashboard. Remember — dashboards are shared by everyone on your team, so think twice before you delete something that someone else might be using!
+
+To delete a dashboard, click the pencil-looking **Edit** icon in the top right of the dashboard, then click **Delete**.
+
+### Fullscreen dashboards
+
+After you've made your ideal dashboard you may want to put it on a TV or present it in some other visible space to help keep your team up-to-date throughout the day.
+
+To enter fullscreen mode just click the fullscreen icon in the top right of the dashboard.
+
+Once you've entered fullscreen mode you can also switch the dashboard into "Night mode" for higher contrast.
+
+![Night mode](images/dashboards/DashboardNightMode.png)
+
+### Auto refresh
+If your data is more realtime in nature you can set your dashboard up to auto refresh.
+
+![Autorefresh](images/dashboards/DashboardAutorefresh.png)
+
+You can set your dashboard to update in 1, 5, 10, 15, 30, and 60 minute intervals depending on how fresh you need the data to be.
+
+Enabling auto refresh will re-run all the queries on the dashboard at the interval you choose, so keep the size of the dashboard and the complexity of the questions in mind when setting up auto refresh.
+
+Combining fullscreen mode and auto refresh is a great way to keep your team in sync with your data throughout the day.
+
+### Configuring a dashboard through its URL
+
+It is possible to amend URL of the dashboard to automatically enter fullscreen, enable night mode or auto-refresh the dashboard. This allows you to configure the dashboard even when you do not have any input access to the device where the dashboard will be displayed, like scripted screens, for example.
+
+To configure a dashboard using its URL, you can add the following optional keywords: `fullscreen`, `night`, or `refresh`. Here's an example:
+
+`https://metabase.mydomain.com/dash/2#refresh=60&fullscreen&night`
+
+The part that says `refresh=60` sets the dashboard to automatically refresh every 60 seconds, `fullscreen` sets it to fullscreen mode, and `night` sets it to night mode (night mode only works when using fullscreen). Use an `&` in between keywords, and make sure there's a hash `#` after the dashboard's ID number.
+
+## Tips on Creating Helpful Dashboards
+To make a really helpful dashboard, you need to first decide what you want the dashboard to tell about your data. What questions will give you insight into what you want to know? It helps to think of a topic or theme for your dashboard — something like “customer satisfaction,” or “second quarter sales goals,” for example.
+
+Once you’ve decided what kinds of questions your dashboard is going to answer, create and save your individual questions from the question builder and save them. Next you can add your saved questions to your dashboard and arrange them in a way that makes it easy to scan and understand.
+
+Some tips:
+
+*  Place the most important saved question cards near the top of the dashboard, and/or make them bigger than the other cards. That will help draw people’s attention to what matters most.
+*  If you have more than 10 cards on a dashboard, think about breaking the dashboard into two separate ones. You don't want to overwhelm people with too much information, and each dashboard should revolve around one theme or topic. Remember — you can make as many dashboards as you want, so you don’t have to cram everything into just one.
+* Consider [adding filters to your dashboard](06-dashboards.md#dashboard-filters) to make them more useful and flexible. For example, instead of your dashboard being full of questions that are restricted to a specific time span, you can make more general questions and use dashboard filters to change the time span you're looking at.
+
+---
+
+## Next: Adding dashboard filters
+Make your dashboards more flexible and powerful by [adding dashboard filters](07-dashboard-filters.md).

docs/users-guide/07-dashboard-filters.md

+## Dashboard Filters
+
+![Dashboard Filters](images/dashboard-filters/dashboard-filters.png)
+
+Have you ever found yourself in a situation where it seems like you need to create nearly identical copies of the same dashboard, with just one different variable? Maybe you have an Earnings dashboard, but you want to see the data for each city your business is in, or maybe you have a KPI dashboard that you want to see broken out by month.
+
+Instead of creating duplicate dashboards, you can use Metabase’s dashboard filters feature to create simple toggles to change a variable for all the cards on a dashboard.
+
+### Adding a new filter
+
+To add a filter to a dashboard, first enter dashboard editing mode, then click the Add a Filter button that appears in the top-right.
+
+![Add a Filter](images/dashboard-filters/01-add-filter.png)
+
+You can choose from a number of filter types: time, location, ID, or other categories. The type of filter you choose will determine what the filter widget will look like, and will also determine what fields you’ll be able to filter your cards by. Let’s try a time filter, and then select the Month and Year option.
+
+![Choose filter type](images/dashboard-filters/02-filter-type.png)
+
+Now we’ve entered a new mode where we’ll need to wire up each card on our dashboard to our new filter. If there’s a card on your dashboard that you don’t want to use with the filter, or that it doesn’t make sense to use with the filter, that’s okay — it’ll just fade out when you use the filter.
+
+![Wiring up the cards](images/dashboard-filters/03-wiring-cards.png)
+
+So here’s what we’re doing — when we pick a month and year with our new filter, the filter needs to know which field in the card to filter on. For example, if we have a `Total Orders` card, and each order has a `Date Ordered` as well as a `Date Delivered`, we have to pick which of those fields to filter — do we want to see all the orders *placed* in January, or do we want to see all the orders *delivered* in January? So, for each card on our dashboard, we’ll pick a date field to connect to the filter. If one of your cards says there aren’t any valid fields, that just means that card doesn’t contain any fields that match the kind of filter you chose.
+
+![Select fields](images/dashboard-filters/04-select-fields.png)
+
+Before we click the `Done` button at the top of the screen, we can also customize the label of our new filter by clicking on the pencil icon next to it. We’ll type in a new label and hit enter. Now we’ll click `Done`, and then save the changes to our dashboard with the `Save` button.
+
+![Edit the filter label](images/dashboard-filters/05-edit-label.png)
+
+You can add multiple filters to your dashboard following the same steps. We just recommend that you try to stick to just two or three of them for a single dashboard so you don’t confuse your users.
+
+### Editing a filter
+
+To edit a filter, enter dashboard editing mode, then click the `Edit` button on the filter you want to change. You an also click `Remove` to get rid of a filter. If you do this by accident, just click `Cancel` in the top-right to exit dashboard editing mode without saving your changes.
+
+![Edit or remove a filter](images/dashboard-filters/06-edit-and-remove.png)
+
+### Setting a default value
+
+If you want one of your filters to start with a default value when you load the dashboard it’s in, while in filter editing mode just click on the filter to select a value. Click the blue X if you want to remove the default value.
+
+![Set a default value](images/dashboard-filters/07-default-value.png)
+
+### Using filters
+
+Once you’ve added a filter to your dashboard, just click on it to select a value and activate the filter. To stop filtering, just click the blue X. To change the filter, click anywhere else on it.
+
+![Using a filter](images/dashboard-filters/08-use-filter.png)
+
+### Best practices
+
+Here are a few tips to get the most out of dashboard filters:
+- Try to keep the number of filters you add to a dashboard to two or three. This will make it easier for your teammates to quickly and easily understand what options are available to them when viewing your dashboard.
+- While you can add dashboard filters to a dashboard that already has a bunch of cards in it, it can be easier to start a new dashboard and think about what filters you intend to add to it, and then make sure that you only put cards in that dashboard that can be used with the filters.
+
+### Some things to keep in mind
+
+- When you activate a dashboard filter, any card that isn’t wired up to the filter will fade out to indicate it’s not being filtered. If you activate more than one filter at the same time, cards will fade out unless they’re wired up to *every* active filter.
+- If you have a card with multiple series on it that you want to use with a dashboard filter, then just make sure to select a filtering field for each of the series in the card.
+- While connecting cards to a filter, you might see a warning message that says, `The values in this field don’t overlap with the values of any other fields you’ve chosen`. For example, maybe you selected the `Type of Pants` field for one card, but the `Types of Boats` field for another card; if you’re using those fields for the same filter, this is problematic because the filter would then give options to the user that don’t work for both cards.
+- You can’t use a dashboard filter with a field in a question if that field is already being used in the definition of the question. For example, say you have a question called `Orders in January`, which counts all the orders and has a filter on the `Date Order Was Placed` field to only select the orders placed January — you can’t then connect a dashboard filter to the `Orders in January` card through the `Date Order Was Placed` field, because that field is already being used to filter the underlying question.
+
+---
+
+## Next: Charts with multiple series
+We'll learn how to [create charts with multiple lines, bars, and more](08-multi-series-charting.md) next.

docs/users-guide/09-multi-series-charting.md → docs/users-guide/08-multi-series-charting.md

-# Charts with multiple series
+## Charts with multiple series
 
 Data in isolation is rarely all that useful. One of the best ways to add context and clarity when communicating with data is to show data side-by-side with other data. Here are just a few  examples of data that is better together than apart.
 
@@ -7,7 +7,7 @@ Data in isolation is rarely all that useful. One of the best ways to add context
 - New users per day vs. returning users per day.
 - Orders per day from a few different product lines.
 
-## In Metabase there are two main ways to get data side-by-side.
+### In Metabase there are two main ways to get data side-by-side.
 
 1. Combining two existing saved questions that share a common dimension (like time) on a dashboard
 
@@ -17,7 +17,7 @@ e.g. Let me see revenue over time and cost over time together.
 
 e.g. The count of users by region over time.
 
-## Combining two existing saved questions
+### Combining two existing saved questions
 If you already have two or more saved questions you’d like to compare, and they share a dimension, they can be combined on any dashboard. Here’s how:
 
 1. Add a question with a dimension like time or a category to a dashboard. In practice, these will usually be line charts or bar charts.
@@ -40,15 +40,15 @@ Once you have your chart looking how you’d like, hit done and your changes wil
 
 ![multiseriefinished](images/MultiSeriesFinished.png)
 
-### A quick note about SQL based questions.
+#### A quick note about SQL based questions.
 Metabase has less information about SQL based questions, so we cannot guarantee if they can be added reliably. You'll see a little warning sign next to SQL questions to indicate this and when you try adding them just be aware it may not work.
 
-##  Combining scalars
+###  Combining scalars
 If you need to compare flat numbers and get a sense of how they differ, Metabase also lets you turn multiple scalars into a bar chart. To do this, follow the same process outlined above. While editing a dashboard, click “edit data” on the scalar of your choice and then select the other scalars you’d like to see represented on the bar chart.
 
 At Metabase, we use this to create simple funnel visualizations.
 
-## Creating a multi-series visualization in the query builder.
+### Creating a multi-series visualization in the query builder.
 If you’re creating a new question in the query builder, you can also view the result as a multi-series visualization. To do this you’ll need to add two dimensions to your question and use an aggregation that isn’t just “raw data.”
 
 As an example, we might want to see which service is referring the most people to our product this month.
@@ -63,10 +63,10 @@ If we switch the resulting table to a line or bar chart we can now see a multi-s
 
 It’s worth noting that at this time you won’t be able to add another saved question to multi-series visualizations made in this fashion.  Metabase can only visualize up to 10 values of a dimension at once, so you may need to filter the values if you're selecting a field that contains a lot of values like "State."
 
-## Other multiple series tips
+### Other multiple series tips
 - When displaying multiple series it’s important to keep legibility in mind. Combining many series can sometimes decrease the communication value of the data.
 
-## To recap:
+### To recap:
 
 - Existing saved questions can be combined and displayed on dashboards when editing the dashboard.
 - Scalars can be combined to create bar charts and simple funnels
@@ -75,5 +75,7 @@ It’s worth noting that at this time you won’t be able to add another saved q
 Go forth and start letting your data get to know each other.
 
 ---
-## That’s it!
-If you still have questions, or want to share Metabase tips and tricks, head over to our [discussion board](http://discourse.metabase.com/). See you there!
+
+## Next: Getting reports with Pulses
+
+Pulses let you send out a group of saved questions on a schedule via email or Slack. [Get started with Pulses](09-pulses.md).

docs/users-guide/07-pulses.md → docs/users-guide/09-pulses.md

@@ -47,5 +47,6 @@ If you want to delete a pulse, you can find that option at the bottom of the edi
 
 ---
 
-## Next: data model references
-Sometimes you’ll need help understanding what data is available to you and what it means. Metabase provides a way for your administrators and data experts to build a [data model reference](08-data-model-reference.md) to help you make sense of your database.
+## Next: Connecting Metabase to Slack with Metabot 🤖
+
+If your team uses Slack to communicate, you can [use Metabot](10-metabot.md) to display your saved questions directly within Slack whenever you want.

docs/users-guide/10-metabot.md

-# Getting answers in Slack with Metabot
+## Getting answers in Slack with Metabot
 
 You can already send data to Slack on  a set schedule via [Pulses](http://www.metabase.com/docs/latest/users-guide/07-pulses) but what about when you need an answer right now? Say hello to Metabot.
 
 Metabot helps add context to conversations you’re having in Slack by letting you insert results from Metabase.
 
-## Connecting to Slack.
+### Connecting to Slack.
 To use Metabot with Slack you’ll first need to connect Metabase to your Slack with an API token.
 
 See [Setting up Slack](http://www.metabase.com/docs/v0.15.1/administration-guide/07-setting-up-slack) for more information.
 
 
-## What can Metabot do?
+### What can Metabot do?
 
 Metabot can show individual questions and also lists of questions that have already been asked in Metabase.
 
@@ -18,10 +18,10 @@ If you ever need help remembering what Metabot can do, just type ```metabot help
 
 ![Metabot help](images/metabot/MetabotHelp.png)
 
-## Showing questions
+### Showing questions
 
 To see a question from Metabase in Slack type
-```metabot show "<question-name>"``` where question name is the title of one of saved questions. If you have several similarly named questions Metabot will ask you to differentiate between the two by typing the number next to the name.
+'''metabot show "<question-name>"''' where question name is the title of one of saved questions. If you have several similarly named questions Metabot will ask you to differentiate between the two by typing the number next to the name.
 
 ![Metabot similar](images/metabot/MetabotSimilarItems.png)
 
@@ -42,3 +42,10 @@ If you don’t have a sense of which questions you want to view in  Slack, you c
 - Search for questions by typing ```metabot show <search-term>```
 - Get a list of questions by typing ```metabot list```
 - ```metabot help``` lets you see everything Metabot can do if you forget or need more information
+
+
+---
+
+## Next:
+
+Sometimes you’ll need help understanding what data is available to you and what it means. Metabase provides a way for your administrators and data experts to build a [data model reference](11-data-model-reference.md) to help you make sense of your data.

docs/users-guide/08-data-model-reference.md → docs/users-guide/11-data-model-reference.md

@@ -20,5 +20,6 @@ If you click on a field you’re interested in, you’ll see a description of th
 In addition to looking at a table's fields, you can also look at its connections if your table includes any. Connections show up here if there’s a field in the table you’re looking at that’s included in another table. Click on **Connections** (located next to **Field** button) to view the connected tables.
 
 ---
-## Next: Multi series charting
-Next we'll take a look at how to combine what we've learned so far and [visualize multiple series on a chart](09-multi-series-charting.md).
+
+## That’s it!
+If you still have questions, or want to share Metabase tips and tricks, head over to our [discussion board](http://discourse.metabase.com/). See you there!