initial multi-series documentation

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

@@ -5,8 +5,8 @@ Sometimes, as you’re looking at all the various tables and data in your databa
 
 ![bookicon](./images/Bookicon.png)
 
-After clicking the icon, the **Data Reference** sidebar will open. It lists all the databases you have access to and the tables inside them. 
- 
+After clicking the icon, the **Data Reference** sidebar will open. It lists all the databases you have access to and the tables inside them.
+
 ![datareference](images/DataReference.png)
 
 Click on the table you would like to explore further to see a description of it and a list of all the fields it contains. Each table or field will only contain a description if your admin wrote something there.
@@ -20,6 +20,5 @@ 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.
 
 ---
-## 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: 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).

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

+06-sharing-answers.md
+
+# 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.
+
+- Your company’s revenue vs. its costs over time
+- Average order price this month and user signups for that month
+- New users per day vs. returning users per day.
+- Orders per day per from a few different product lines.
+
+## 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
+
+e.g. Let me see revenue over time and cost over time together.
+
+
+2. Asking a question that involves multiple dimensions in the query builder (or in SQL if you’re fancy).
+
+e.g. The count of users by region over time.
+
+
+## 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.
+
+2. While in edit mode on the dashboard, hovering on the card will show a “Edit data” button. Click this button to start adding series that you want to compare to the first series..
+
+[ edit data control image ]
+
+3. In the Edit Data modal you’ll see the original question, and on the right you’ll see a list of compatible questions you can choose from. Check the box next to any questions you’d like to see side-by-side with the original, and Metabase will add it to the same chart.
+
+[ edit data modal image ]
+
+The X and Y axis will automagically update if necessary and Metabase will create a legend using the existing card titles to help you understand which question maps to which series on the chart. Repeat this process as many times as you need.
+
+To remove a series either uncheck the box, or click the x next to the title in the legend above the chart.
+
+Once you have your chart looking how you’d like, hit done and your changes will be shown on the card in the dashboard. Depending on how dense your data is, at this point you might want to consider enlarging your chart to make sure the data is legible.
+
+[end result image]
+
+
+### A quick note about SQL based questions.
+You’ll see SQL-based questions in the list of questions you can combine as well, but since SQL-based questions don’t have the same metadata we use for questions built using the query builder, we can’t always guarantee beforehand that they will be able to be added to the question you’re looking at. You’ll see a little warning next to SQL based cards to indicate this.
+
+
+##  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.
+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.
+
+(In the sample dataset that ships with Metabase this would involve using the Referrer and Created At dimensions of the “People” table.)
+
+To do this we’d select “Count of rows” and then add “Referrer” and “Created At.” Then, we’d add a filter to limit the results to just this month. You can learn more about how to work with the query builder in the “Asking questions” section of the user guide.
+
+If we switch the resulting table to a line or bar chart we can now see a multi-series visualization of how each referrer has performed for us this month.
+
+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.
+
+
+## Other tips with multiple series
+- When displaying multiple series it’s important to keep legibility in mind. Combining many series can sometimes decrease the communication value of the data so it’s important to always start from
+
+## 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
+- You can produce a multi-series visualization in the query builder by adding two dimensions to your query.
+
+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!

docs/users-guide/start.md

@@ -18,4 +18,6 @@
 
 > [Some helpful tips on building your data model](08-data-model-reference.md)
 
+> [Visualizing multiple series](09-data-model-reference.md)
+
 Let's get started with an overview of [What Metabase does](01-what-is-metabase.md).