docs - break out charts into individual pages (#30129)

docs/configuring-metabase/appearance.md

@@ -53,7 +53,7 @@ Custom colors are unavailable for:
 
 - [Number charts](../questions/sharing/visualizing-results.md#numbers)
 - [Trend charts](../questions/sharing/visualizing-results.md#trends)
-- [Funnel charts](../questions/sharing/visualizing-results.md#funnel)
+- [Funnel charts](../questions/sharing/visualizing-results.md#funnel-charts)
 - Conditional formatting ([tables](../questions/sharing/visualizing-results.md#tables) and [pivot tables](../questions/sharing/visualizing-results.md#pivot-table))
 - [Maps](../questions/sharing/visualizing-results.md#maps)
 

docs/questions/sharing/visualizations/combo-chart.md

+---
+title: Combo charts
+---
+
+# Combo charts
+
+Combo charts let you combine bars and lines (or areas) on the same chart.
+
+![Line + bar](../../images/combo-chart.png)
+
+Metabase will pick one of your series to display as a line, and another to display as a bar by default. Open up the visualization settings to change which series are lines, bars, or areas, as well as to change per-series settings like colors. Click the down arrow icon on the right of a series to see additional options:
+
+![Line + bar](../../images/combo-chart-settings.png)
+
+To use a Combo chart you'll either need to have two or more metrics selected in the Summarize By section of your question, with one or two grouping columns, like this:
+
+![Data for Line + Bar chart](../../images/combo-chart-data-1.png)
+
+Or you'll need a question with a single metric and two grouping columns, like this:
+
+![Data for Line + Bar chart](../../images/combo-chart-data-2.png)
\ No newline at end of file

docs/questions/sharing/visualizations/detail.md

+---
+title: Detail
+---
+
+# Detail
+
+The **Detail** visualization shows a single result record (row) in an easy-to-read, two-column display.
+
+![Detail of a record in the account table](../../images/detail.png)
+
+You can cycle through records using the arrow buttons.
+

docs/questions/sharing/visualizations/funnel.md

+---
+title: Funnel charts
+---
+
+# Funnel charts
+
+**Funnels** are commonly used in e-commerce or sales to visualize how many customers are present within each step of a checkout flow or sales cycle. At their most general, funnels show you values broken out by steps, and the percent decrease between each successive step. To create a funnel in Metabase, you'll need to have a table with at least two columns: one column that contains the metric you're interested in, and another that contains the funnel's steps.
+
+For example, I might have an Opportunities table, and I could create a question that gives me the number of sales leads broken out by a field that contains stages such as `Prospecting`, `Qualification`, `Proposal`, `Negotiation`, and `Closed`. In this example, the percentages shown along the x-axis tell you what percent of the total starting opportunities are still present at each subsequent step; so 18.89% of our total opportunities have made it all the way to being closed deals. The number below each percent is the actual value of the count at that step — in our example, the actual number of opportunities that are currently at each step. Together, these numbers help you figure out where you're losing your customers or users.
+
+![Funnel](../../images/funnel.png)
\ No newline at end of file

docs/questions/sharing/visualizations/gauge.md

+---
+title: Gauge chart
+---
+
+# Gauge chart
+
+Ah, **gauges**: you either love 'em or you hate 'em. …Or you feel "meh" about them, I guess. Whatever the case, gauges allow you to show a single number in the context of a set of colored ranges that you can specify. By default, when you choose the Gauge visualization, Metabase will create red, yellow, and green ranges for you.
+
+![Gauge](../../images/gauge.png)
+
+Open up the visualization settings to define your own ranges, choose colors for them, and optionally add labels to some or all of your ranges:
+
+![Gauge settings](../../images/gauge-settings.png)
\ No newline at end of file

docs/questions/sharing/visualizations/line-bar-and-area-charts.md

+---
+title: Line, bar, and area charts
+---
+
+# Line, bar, and area charts
+
+They're pretty useful.
+
+## Line charts
+
+**Line charts** are best for displaying the trend of a number over time, especially when you have lots of x-axis values. For more, check out our [Guide to line charts](https://www.metabase.com/learn/basics/visualizing-data/line-charts.html) and [Time series analysis](https://www.metabase.com/learn/time-series) tutorials.
+
+![Trend lines](../../images/trend-lines.png)
+
+## Bar charts
+
+![Bar chart](../../images/bar.png)
+
+If you're trying to group a number by a column that has a lot of possible values, like a Vendor or Product Title field, try visualizing it as a **row chart**. Metabase will show you the bars in descending order of size, with a final bar at the bottom for items that didn't fit.
+
+![Row chart](../../images/row.png)
+
+If you have a bar chart like Count of Users by Age, where the x-axis is a number, you'll get a special kind of chart called a **[histogram](https://www.metabase.com/learn/basics/visualizing-data/histograms.html)**, where each bar represents a range of values (called a "bin"). Note that Metabase will automatically bin your results any time you use a number as a grouping, even if you aren't viewing a bar chart. Questions that use latitude and longitude will also get binned automatically.
+
+## Histograms
+
+![Histogram](../../images/histogram.png)
+
+By default, Metabase will automatically choose a good way to bin your results. But you can change how many bins your result has, or turn the binning off entirely, by clicking on the area to the right of the column you're grouping by:
+
+![Binning options](../../images/histogram-bins.png)
+
+## Area charts
+
+**Area charts** are useful when comparing the proportions of two metrics over time. Both bar and area charts can be stacked.
+
+![Stacked area chart](../../images/area.png)
+
+
+
+## Options for line, bar, and area charts
+
+These three charting types have very similar options, which are broken up into the following:
+
+### Trend lines
+
+**Trend lines** are another useful option for line, area, bar, and scatter charts. If you have a question where you're grouping by a time field, open up the visualization settings and turn the **Show trend line** toggle on to display a trend line. Metabase will choose the best type of line to fit to the trend of your series. Trend lines will even work if you have multiple metrics selected in your summary. But trend lines won't work if you have any groupings beyond the one time field.
+
+![Trend lines](../../images/trend-lines.png)
+
+### Data
+
+Here's where you can choose the columns you want to plot on your x and y axes. This is mostly useful if your table or result set contains more than two columns, like if you're trying to graph fields from an unaggregated table. You can also add additional metrics to your chart by clicking the **Add another series** link below the y-axis dropdown, or break your current metric out by an additional dimension by clicking the **Add a series breakout** link below the x-axis dropdown (note that you can't add an additional series breakout if you have more than one metric/series).
+
+### Display
+
+There's quite a bit you can do in this tab, but the options available will depend on the data in your chart.
+
+- **Set the colors and labels** for the series on your chart.
+- **Change the style of your lines** for Line and Area charts, and choose whether to display dots on the lines.
+- **Specify how to handle missing values**. Use the "Replace missing values with…" setting to change how your chart deals with missing values. You can use linear interpolation, or display those points as zero or as nothing.
+- **Add a goal line**. 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.
+- **Add a trend line**. If you're looking at a time series chart, you can turn on a trend line to show where things are heading.
+- **Show values on data points**. The default setting will try and fit as many values on your chart as will fit nicely, but you can also force Metabase to show the values for each and every data point, which it will do begrudgingly. Showing values also works with multi-series charts, but be aware that the more data points you add, the more crowded with values the charts will become.
+
+### Axes
+
+There are three main ways to configure axes:
+
+- **Change the scale for your axes**. If you're looking at a time series chart, your x-axis can use a time series scale or an ordinal one. When using "Timeseries", it will always be displayed in ascending order, so oldest to newest, while "Ordinal" will display in the order the data is returned. Your y-axis can use a linear, power, or logarithmic scale.
+- **Hide or show the tick marks on your axes**. You can also choose to rotate the tick marks on the x-axis to help them fit better.
+- **Edit the range of your y-axis**. Metabase sets an automatic range by default, but you can toggle that off and input a custom minimum and maximum value for the y-axis if you'd like.
+
+### Labels
+
+Here's where you can choose to hide the **label** for your x- or y-axis. You can also customize the text for your axes labels here.
+
+## Further reading
+
+- [Guide to line charts](https://www.metabase.com/learn/visualization/line-charts)
+- [Master the bar chart](https://www.metabase.com/learn/visualization/bar-charts)
+- [Visualize your data as a histogram](https://www.metabase.com/learn/visualization/histograms)
\ No newline at end of file

docs/questions/sharing/visualizations/map.md

+---
+title: Maps
+---
+
+# Maps
+
+When you select the **Map** visualization setting, Metabase will automatically try and pick the best kind of map to use based on the table or result set. Here are the maps that Metabase uses:
+
+- **United States Map**. Creating a map of the United States from your data requires your results to contain a column that contains names of states or two-letter state codes. This lets you do things like visualize the count of your users broken out by state, with darker states representing more users.
+- **World Map**. To visualize your results in the format of a map of the world broken out by country, your result must contain a column with two-letter country codes. (E.g., count of users by country.)
+
+![Region map](../../images/map.png)
+
+- **Pin Map**. If your results contains a latitude and longitude field, Metabase will try to display the results as a pin map of the world. Metabase will put one pin on the map for each row in your table, based on the latitude and longitude fields. You can try this with the Sample Database that's included in Metabase: start a new question and select the People table, use `raw data` for your view, and choose the Map option for your visualization. You'll see a map of the world, with each dot representing the latitude and longitude coordinates of a single person from the People table.
+
+![Pin map](../../images/pin-map.png)
+
+When you open up the Map options, you can manually switch between a region map (e.g., United States) and a pin map. If you're using a region map, you can also choose which field to use as the measurement, and which field to use as the region (e.g., State or Country).
+
+Metabase also allows administrators to add custom region maps via GeoJSON files through the Metabase **Admin Panel**.
+
+## Further reading
+
+- [Visualizing data with maps](https://www.metabase.com/learn/basics/visualizing-data/maps).
\ No newline at end of file

docs/questions/sharing/visualizations/numbers.md

+---
+title: Numbers
+---
+
+# Numbers
+
+The **Numbers** option is for displaying a single number, nice and big. The options for numbers include:
+
+![Number](../../images/number.png)
+
+- **Adding character prefixes or suffixes** to it (so you can do things like put a currency symbol in front or a percent at the end),
+- **Setting the number of decimal places** you want to include, and
+- **Multiplying your result by a number** (like if you want to multiply a decimal by 100 to make it look like a percent). If you want to _divide_ by a number, then just multiply it by a decimal (e.g, if your result is `100`, but you want it to display as `1`, simply multiply it by 0.01).

docs/questions/sharing/visualizations/pie-or-donut-chart.md

+---
+title: Pie or donut charts
+---
+
+# Pie or donut charts
+
+A **pie or donut chart** can be used when breaking out a metric by a single dimension, especially when the number of possible breakouts is small, like users by gender. If you have more than a few breakouts, like users per country, it's usually better to use a bar chart so that your users can more easily compare the relative sizes of each bar.
+
+The options for pie charts let you choose which field to use as your measurement, and which one to use for the dimension (i.e. the pie slices). You can also customize the color of each slice, the pie chart's legend, whether or not to show each slice's percent of the whole in the legend, and the minimum size a slice needs to be in order for Metabase to display it.
+
+![Inedible donut chart](../../images/donut.png)

docs/questions/sharing/visualizations/pivot-table.md

+---
+title: Pivot table
+---
+
+# Pivot table
+
+Pivot tables allow you swap rows and columns, group data, and include subtotals in your table. You can group one or more metrics by one or more dimensions.
+
+Pivot tables are not currently available for the following databases in Metabase:
+
+- Druid
+- Google Analytics
+- MongoDB
+
+Pivot tables work for simple and custom questions with summarized data for all other [officially supported databases](../../../databases/connecting.md). They don't work for questions that lack aggregate data, and they don't work for questions written in SQL, as Metabase would need to modify your SQL code in order to calculate subtotals. If you really need to use SQL, the workaround here is to create your question in two steps: first do all the complex things you need to do in SQL, save the results as a question, then use that saved SQL question as the starting point for a new GUI question which summarizes that data.
+
+In the settings for the Pivot Table visualization, you can assign fields to one of three "buckets":
+
+- Fields to use for the table **rows**
+- Fields to use for the table **columns**
+- Fields to use for the table **values**
+
+Let's say we ask the following question in the notebook editor:
+
+![Pivot table notebook](../../images/pivot-table-notebook.png)
+
+From the `Orders` table, we've summarized by the count of orders and the average order total, and grouped by `User → State`, `Product → Category`, and `Created At` binned by year. Here's our question visualized as a pivot table:
+
+![Pivot table options](../../images/pivot-table-options.png)
+
+We've assigned the fields `User → State` and `Created At` to table rows, and assigned the `Product -> Category` field to generate our columns: Doohickey, Gadget, and so on. We can drag and drop dimensions between the row and column buckets, and add aggregations to the table values bucket. For example, if we assign a field to the columns bucket, Metabase will pivot that field and render each unique value of that field as a column heading.
+
+You can put multiple fields in the "rows" and "columns" buckets, but note that the order of the fields changes how Metabase displays the table: each additional field will nest within the previous field.
+
+Where it makes sense, Metabase will automatically include subtotals for grouped rows. For example, as in the image above, because we've grouped our rows first by `State`, then by `Created At`, Metabase will list each year for each `State`, and aggregate the metric(s) for that subgroup. For orders placed in Wisconsin, Metabase would sum the count of orders for each category, and find the average annual order total in each product category in Wisconsin.
+
+To collapse a group on a pivot table, you can click on the minus (–) button next to the group's heading (or the plus (+) button to expand it). When you save a pivot table, Metabase will remember which groups were expanded and which were collapsed.
+
+For more, check out [How to create a pivot table to summarize your data](https://www.metabase.com/learn/basics/visualizing-data/how-to-create-pivot-tables.html).
\ No newline at end of file

docs/questions/sharing/visualizations/progress-bar.md

+---
+title: Progress bars
+---
+
+# Progress bars
+
+**Progress bars** are for comparing a single number to a goal value that you set. Open up the settings for your progress bar to choose a value for your goal, and Metabase will show you how far away your question's current result is from the goal.
+
+![Progress bar](../../images/progress.png)

docs/questions/sharing/visualizations/scatterplot-or-bubble-chart.md

+---
+title: Scatterplots and bubble charts
+---
+
+# Scatterplots and bubble charts
+
+**Scatterplots** are useful for visualizing the correlation between two variables, like comparing the age of your users vs. how many dollars they've spent on your products. To use a scatterplot, you'll need to ask a question that results in two numeric columns, like `Count of Orders grouped by Customer Age`. Alternatively, you can use a raw data table and select the two numeric fields you want to use in the chart options.
+
+If you have a third numeric field, you can also create a **bubble chart**. Select the Scatter visualization, then open up the chart settings and select a field in the **bubble size** dropdown. This field will be used to determine the size of each bubble on your chart. For example, you could use a field that contains the total dollar amount for each x-y pair — i.e. larger bubbles for larger total dollar amounts spent on orders.
+
+Scatterplots and bubble charts also have similar chart options as line, bar, and area charts, including the option to display trend or goal lines.
+
+![Scatter](../../images/scatter.png)
\ No newline at end of file

docs/questions/sharing/visualizations/table.md

+---
+title: Tables
+---
+
+# Tables
+
+The **Table** option is good for looking at tabular data (duh), or for lists of things like users or orders. The visualization options for tables allow you to add, hide, or rearrange fields in the table you're looking at, as well as modify their formatting. Check out [Everything you can do with the table visualization](https://www.metabase.com/learn/basics/visualizing-data/table.html).
+
+## Rearranging, adding, and removing columns
+
+Open up the settings for your table and you'll see the Columns tab, which displays all the columns currently being shown in the table. Below that you'll see a list of more columns from linked tables, if any, that you can add to the current table view.
+
+To hide a column, click the X icon on it; that'll send it down to the **More columns** area in case you want to bring it back. To add a linked column, just click the + icon on it, which will bring it to the **Visible columns** section. Click and drag any of the columns listed there to rearrange the order in which they appear. Another super easy way to rearrange columns without having to open up the visualization settings is to simply click and drag on a column's heading to move it where you'd like it to go.
+
+> Changing these options doesn't change the actual table itself; these changes create a custom view of the table that you can save as a **question** in Metabase and refer to later, share with others, or add to a [dashboard](../../../dashboards/start.md).
+
+## Column formatting options
+
+To format the display of any column in a table, click on the column heading and choose the `Formatting` option (you can also get there by clicking on the gear on any column when in the `Columns` tab of the visualization settings).
+
+![Column formatting](../../images/column-header-formatting.png)
+
+The options you see will differ depending on the type of column you're viewing:
+
+### Dates
+
+- **Date style** gives you a bunch of different choices for how to display the date.
+- **Abbreviate names of days and months**, when turned on, will turn things like `January` to `Jan`, and `Monday` to `Mon`.
+- **Show the time** lets you decide whether or not to display the time, and if so, how. You can include hours and minutes, and additionally seconds and milliseconds.
+
+### Numbers
+
+- **Show a mini bar chart** will display a small horizontal bar next to each number in this column to show its size relative to the other values in the column.
+- **Style** lets you choose to display the number as a plain number, a percent, in scientific notation, or as a currency.
+- **Separator style** gives you various options for how commas and periods are used to separate the number.
+- **Minimum number of decimal places** forces the number to be displayed with exactly this many decimal places.
+- **Multiply by a number** multiplies each number in this column by whatever you type here. Just don't type an emoji here; it almost always causes a temporal vortex to manifest.
+- **Add a prefix/suffix** lets you put a symbol, word, or whatever before or after each cell's value.
+
+### Currency
+Currency columns have all the same options as numbers, plus the following:
+
+- **Unit of Currency** lets you change the unit of currency from whatever the system default is.
+- **Currency label style** allows you to switch between displaying the currency label as a symbol, a code like (USD), or the full name of the currency.
+- **Where to display the unit of currency** lets you toggle between showing the currency label in the column heading or in every cell in the column.
+
+### Conditional table formatting
+
+Sometimes it's helpful to highlight certain rows or columns in your tables when they meet a specific condition. You can set up conditional formatting rules by going to the visualization settings while looking at any table, then clicking on the **Conditional Formatting** tab.
+
+![Conditional formatting](../../images/conditional-formatting.png)
+
+When you add a new rule, you'll first need to pick which column(s) should be affected. Your columns can be formatted in one of two ways:
+
+- **Single color**. Pick single color if you want to highlight cells in the column if they're greater, less than, or equal to a specific number, or if they match or contain a certain word or phrase. You can optionally highlight the whole row of a cell that matches the condition you pick so that it's easier to spot as you scroll down your table.
+- **Color range**. Choose color range if you want to tint all the cells in the column from smallest to largest or vice a versa. This option is only available for numeric columns.
+
+You can set as many rules on a table as you want. If two or more rules disagree with each other, the rule that's on the top of your list of rules will win. You can click and drag your rules to reorder them, and click on a rule to edit it.
+
+### Pivoted tables
+
+If your table is a result that contains one numeric column and two grouping columns, Metabase will also automatically "pivot" your table, like in the example below. Pivoting takes one of your columns and rotates it 90 degrees ("pivots" it) so that each of its values becomes a column heading. If you open up the visualization settings by clicking the gear icon, you can choose which column to pivot in case Metabase got it wrong; or you can also turn the pivoting behavior off entirely.
+
+![Pivot table](../../images/pivot.png)
+
+This auto-pivoting is distinct from the [pivot table](./pivot-table.md) visualization.

docs/questions/sharing/visualizations/trend.md

+---
+title: Trend
+---
+
+# Trend
+
+![Trend settings](../../images/trend-settings.png)
+
+The **Trend** visualization is great for displaying how a single number has changed over time. To use this visualization, you'll need to have a single number grouped by a Time field, like the Count of Orders by Created At. The Trend will show you the value of the number during the most recent period, as well as how much the number has increased or decreased compared to its value in the previous period. The period is determined by your group-by field; if you're grouping by Day, the Trend will show you the most recent day compared to the day before that.
+
+By default, Trends will display increases as green (i.e. "good") and decreases as red ("bad"). If your number is something where an increase is bad and a decrease is good (such as Bounce Rate, or Costs), you can reverse this behavior in the visualization settings.
\ No newline at end of file

docs/questions/sharing/visualizations/waterfall-chart.md

+---
+title: Waterfall charts
+---
+
+# Waterfall charts
+
+Waterfall charts are a kind of bar chart useful for visualizing results that contain both positive and negative values. Each bar on a waterfall chart shows either an increase or decrease, with a final bar on the right of the chart that represents the total value.
+
+![Waterfall chart](../../images/waterfall-chart.png)
+
+In the example above, the waterfall chart displays "Profit" for each "Product:" apples, bananas, oranges, peaches, and mangos. From left to right, each bar indicates the change in total. The products with green bars indicate positive values (they made a profit). Peaches, however, lost money, indicated by a red bar, which signals a negative value. The bar at the end shows the total profit of all products combined. You can show values on each bar, and change the colors for increases and decreases.
+
+For waterfall charts, you'll want a query that is a single metric grouped by a single dimension: by time or category.
\ No newline at end of file