Repository: pandas-dev/pandas
Pull request: DOC: added plotting module to the api reference docs
- [x ] closes #19777
- [ ] tests added / passed
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry


Problem statement:
API reference is missing the Plotting module
I noticed this when looking for the documentation page for the `scatter_matrix` function.

#### Problem description

I needed to check the parameters I needed to pass to `plotting.scatter_matrix`. Had to go all the way to the source code.

Turns out none of the functions in `_misc.py` are included in the API reference. I added a **Plotting** section after **General functions** and before **Series**. Under that section I added a **Miscellaneous** section which includes:

- scatter_matrix
- radviz
- andrews_curves
- bootstrap_plot
- parallel_coordinates
- lag_plot

Hints from issue discussion:
Submitting a PR for this shortly.

Commit message: added plotting module to the api reference docs

Patch to review:
diff --git a/doc/source/api.rst b/doc/source/api.rst
index 103b0fe9ff019..0f845e0ef3162 100644
--- a/doc/source/api.rst
+++ b/doc/source/api.rst
@@ -246,6 +246,24 @@ Testing
 
    test
 
+.. currentmodule:: pandas.plotting
+
+Plotting
+--------
+
+Miscellaneous
+~~~~~~~~~~~~~
+
+.. autosummary::
+   :toctree: generated/
+
+   andrews_curves
+   bootstrap_plot
+   lag_plot
+   parallel_coordinates
+   radviz
+   scatter_matrix
+
 .. _api.series:
 
 Series
diff --git a/doc/source/savefig/andrews_curve_winter.png b/doc/source/savefig/andrews_curve_winter.png
new file mode 100644
index 0000000000000..abe1dccac7e45
Binary files /dev/null and b/doc/source/savefig/andrews_curve_winter.png differ
diff --git a/doc/source/savefig/andrews_curves.png b/doc/source/savefig/andrews_curves.png
new file mode 100644
index 0000000000000..a57efba69de9a
Binary files /dev/null and b/doc/source/savefig/andrews_curves.png differ
diff --git a/doc/source/savefig/area_plot_stacked.png b/doc/source/savefig/area_plot_stacked.png
new file mode 100644
index 0000000000000..cb32ee883c7f0
Binary files /dev/null and b/doc/source/savefig/area_plot_stacked.png differ
diff --git a/doc/source/savefig/area_plot_unstacked.png b/doc/source/savefig/area_plot_unstacked.png
new file mode 100644
index 0000000000000..6a890dca89aca
Binary files /dev/null and b/doc/source/savefig/area_plot_unstacked.png differ
diff --git a/doc/source/savefig/autocorrelation_plot.png b/doc/source/savefig/autocorrelation_plot.png
new file mode 100644
index 0000000000000..a2ca6e5607ac7
Binary files /dev/null and b/doc/source/savefig/autocorrelation_plot.png differ
diff --git a/doc/source/savefig/bar_plot_ex.png b/doc/source/savefig/bar_plot_ex.png
new file mode 100644
index 0000000000000..00eba10b904cc
Binary files /dev/null and b/doc/source/savefig/bar_plot_ex.png differ
diff --git a/doc/source/savefig/bar_plot_multi_ex.png b/doc/source/savefig/bar_plot_multi_ex.png
new file mode 100644
index 0000000000000..9b5ae7f3df17b
Binary files /dev/null and b/doc/source/savefig/bar_plot_multi_ex.png differ
diff --git a/doc/source/savefig/bar_plot_stacked_ex.png b/doc/source/savefig/bar_plot_stacked_ex.png
new file mode 100644
index 0000000000000..30face6f41651
Binary files /dev/null and b/doc/source/savefig/bar_plot_stacked_ex.png differ
diff --git a/doc/source/savefig/barh_plot_stacked_ex.png b/doc/source/savefig/barh_plot_stacked_ex.png
new file mode 100644
index 0000000000000..e3c75b1e6a00e
Binary files /dev/null and b/doc/source/savefig/barh_plot_stacked_ex.png differ
diff --git a/doc/source/savefig/basics_assign.png b/doc/source/savefig/basics_assign.png
new file mode 100644
index 0000000000000..0c5a7b1c2b138
Binary files /dev/null and b/doc/source/savefig/basics_assign.png differ
diff --git a/doc/source/savefig/bollinger.png b/doc/source/savefig/bollinger.png
new file mode 100644
index 0000000000000..db830a0753e69
Binary files /dev/null and b/doc/source/savefig/bollinger.png differ
diff --git a/doc/source/savefig/bootstrap_plot.png b/doc/source/savefig/bootstrap_plot.png
new file mode 100644
index 0000000000000..fd462170815cb
Binary files /dev/null and b/doc/source/savefig/bootstrap_plot.png differ
diff --git a/doc/source/savefig/box_new_colorize.png b/doc/source/savefig/box_new_colorize.png
new file mode 100644
index 0000000000000..7f5bf070b41ae
Binary files /dev/null and b/doc/source/savefig/box_new_colorize.png differ
diff --git a/doc/source/savefig/box_new_kwargs.png b/doc/source/savefig/box_new_kwargs.png
new file mode 100644
index 0000000000000..9f468786058af
Binary files /dev/null and b/doc/source/savefig/box_new_kwargs.png differ
diff --git a/doc/source/savefig/box_plot_ex.png b/doc/source/savefig/box_plot_ex.png
new file mode 100644
index 0000000000000..4d9acc7e3254a
Binary files /dev/null and b/doc/source/savefig/box_plot_ex.png differ
diff --git a/doc/source/savefig/box_plot_ex2.png b/doc/source/savefig/box_plot_ex2.png
new file mode 100644
index 0000000000000..58586006029da
Binary files /dev/null and b/doc/source/savefig/box_plot_ex2.png differ
diff --git a/doc/source/savefig/box_plot_ex3.png b/doc/source/savefig/box_plot_ex3.png
new file mode 100644
index 0000000000000..afd472ff2a33c
Binary files /dev/null and b/doc/source/savefig/box_plot_ex3.png differ
diff --git a/doc/source/savefig/box_plot_new.png b/doc/source/savefig/box_plot_new.png
new file mode 100644
index 0000000000000..f2a13c3ead64c
Binary files /dev/null and b/doc/source/savefig/box_plot_new.png differ
diff --git a/doc/source/savefig/boxplot_groupby.png b/doc/source/savefig/boxplot_groupby.png
new file mode 100644
index 0000000000000..6ae9751407838
Binary files /dev/null and b/doc/source/savefig/boxplot_groupby.png differ
diff --git a/doc/source/savefig/compare_interpolations.png b/doc/source/savefig/compare_interpolations.png
new file mode 100644
index 0000000000000..8d600d199732c
Binary files /dev/null and b/doc/source/savefig/compare_interpolations.png differ
diff --git a/doc/source/savefig/cubehelix.png b/doc/source/savefig/cubehelix.png
new file mode 100644
index 0000000000000..107f7d725b349
Binary files /dev/null and b/doc/source/savefig/cubehelix.png differ
diff --git a/doc/source/savefig/cubehelix_cm.png b/doc/source/savefig/cubehelix_cm.png
new file mode 100644
index 0000000000000..107f7d725b349
Binary files /dev/null and b/doc/source/savefig/cubehelix_cm.png differ
diff --git a/doc/source/savefig/df_pie_plot.png b/doc/source/savefig/df_pie_plot.png
new file mode 100644
index 0000000000000..2c0ddcb33fd47
Binary files /dev/null and b/doc/source/savefig/df_pie_plot.png differ
diff --git a/doc/source/savefig/df_plot_xy.png b/doc/source/savefig/df_plot_xy.png
new file mode 100644
index 0000000000000..f950ec497671d
Binary files /dev/null and b/doc/source/savefig/df_plot_xy.png differ
diff --git a/doc/source/savefig/errorbar_example.png b/doc/source/savefig/errorbar_example.png
new file mode 100644
index 0000000000000..aa2e7e4ff8fb7
Binary files /dev/null and b/doc/source/savefig/errorbar_example.png differ
diff --git a/doc/source/savefig/ewma_ex.png b/doc/source/savefig/ewma_ex.png
new file mode 100644
index 0000000000000..decb9c8d33369
Binary files /dev/null and b/doc/source/savefig/ewma_ex.png differ
diff --git a/doc/source/savefig/expanding_mean_frame.png b/doc/source/savefig/expanding_mean_frame.png
new file mode 100644
index 0000000000000..7ba0c24b73638
Binary files /dev/null and b/doc/source/savefig/expanding_mean_frame.png differ
diff --git a/doc/source/savefig/frame_hist_ex.png b/doc/source/savefig/frame_hist_ex.png
new file mode 100644
index 0000000000000..147b7bc7fe7af
Binary files /dev/null and b/doc/source/savefig/frame_hist_ex.png differ
diff --git a/doc/source/savefig/frame_plot_basic.png b/doc/source/savefig/frame_plot_basic.png
new file mode 100644
index 0000000000000..989c48933d313
Binary files /dev/null and b/doc/source/savefig/frame_plot_basic.png differ
diff --git a/doc/source/savefig/frame_plot_basic_noleg.png b/doc/source/savefig/frame_plot_basic_noleg.png
new file mode 100644
index 0000000000000..e78ab847d44e9
Binary files /dev/null and b/doc/source/savefig/frame_plot_basic_noleg.png differ
diff --git a/doc/source/savefig/frame_plot_secondary_y.png b/doc/source/savefig/frame_plot_secondary_y.png
new file mode 100644
index 0000000000000..186a8ddbee543
Binary files /dev/null and b/doc/source/savefig/frame_plot_secondary_y.png differ
diff --git a/doc/source/savefig/frame_plot_secondary_y_no_right.png b/doc/source/savefig/frame_plot_secondary_y_no_right.png
new file mode 100644
index 0000000000000..61bb482e2f1d0
Binary files /dev/null and b/doc/source/savefig/frame_plot_secondary_y_no_right.png differ
diff --git a/doc/source/savefig/frame_plot_subplots.png b/doc/source/savefig/frame_plot_subplots.png
new file mode 100644
index 0000000000000..7690410bcaf68
Binary files /dev/null and b/doc/source/savefig/frame_plot_subplots.png differ
diff --git a/doc/source/savefig/frame_plot_subplots_layout.png b/doc/source/savefig/frame_plot_subplots_layout.png
new file mode 100644
index 0000000000000..31cf022aaace1
Binary files /dev/null and b/doc/source/savefig/frame_plot_subplots_layout.png differ
diff --git a/doc/source/savefig/frame_plot_subplots_multi_ax.png b/doc/source/savefig/frame_plot_subplots_multi_ax.png
new file mode 100644
index 0000000000000..52b7ab871ba15
Binary files /dev/null and b/doc/source/savefig/frame_plot_subplots_multi_ax.png differ
diff --git a/doc/source/savefig/greens.png b/doc/source/savefig/greens.png
new file mode 100644
index 0000000000000..c353e181c1dd1
Binary files /dev/null and b/doc/source/savefig/greens.png differ
diff --git a/doc/source/savefig/groupby_boxplot.png b/doc/source/savefig/groupby_boxplot.png
new file mode 100644
index 0000000000000..65a724b5fb624
Binary files /dev/null and b/doc/source/savefig/groupby_boxplot.png differ
diff --git a/doc/source/savefig/groupby_boxplot_vis.png b/doc/source/savefig/groupby_boxplot_vis.png
new file mode 100644
index 0000000000000..65a724b5fb624
Binary files /dev/null and b/doc/source/savefig/groupby_boxplot_vis.png differ
diff --git a/doc/source/savefig/groupby_transform_plot.png b/doc/source/savefig/groupby_transform_plot.png
new file mode 100644
index 0000000000000..d63978c9730f2
Binary files /dev/null and b/doc/source/savefig/groupby_transform_plot.png differ
diff --git a/doc/source/savefig/grouped_hist.png b/doc/source/savefig/grouped_hist.png
new file mode 100644
index 0000000000000..f7015f36e71a8
Binary files /dev/null and b/doc/source/savefig/grouped_hist.png differ
diff --git a/doc/source/savefig/hexbin_plot.png b/doc/source/savefig/hexbin_plot.png
new file mode 100644
index 0000000000000..d549ee0ef4a6b
Binary files /dev/null and b/doc/source/savefig/hexbin_plot.png differ
diff --git a/doc/source/savefig/hexbin_plot_agg.png b/doc/source/savefig/hexbin_plot_agg.png
new file mode 100644
index 0000000000000..a3bf8f5c262d2
Binary files /dev/null and b/doc/source/savefig/hexbin_plot_agg.png differ
diff --git a/doc/source/savefig/hist_new.png b/doc/source/savefig/hist_new.png
new file mode 100644
index 0000000000000..8e51edfb2dcbe
Binary files /dev/null and b/doc/source/savefig/hist_new.png differ
diff --git a/doc/source/savefig/hist_new_kwargs.png b/doc/source/savefig/hist_new_kwargs.png
new file mode 100644
index 0000000000000..3d9672a19d1c5
Binary files /dev/null and b/doc/source/savefig/hist_new_kwargs.png differ
diff --git a/doc/source/savefig/hist_new_stacked.png b/doc/source/savefig/hist_new_stacked.png
new file mode 100644
index 0000000000000..9a3c621c9bae5
Binary files /dev/null and b/doc/source/savefig/hist_new_stacked.png differ
diff --git a/doc/source/savefig/hist_plot_ex.png b/doc/source/savefig/hist_plot_ex.png
new file mode 100644
index 0000000000000..22aeec8d62368
Binary files /dev/null and b/doc/source/savefig/hist_plot_ex.png differ
diff --git a/doc/source/savefig/kde_plot.png b/doc/source/savefig/kde_plot.png
new file mode 100644
index 0000000000000..50a42249cfe4c
Binary files /dev/null and b/doc/source/savefig/kde_plot.png differ
diff --git a/doc/source/savefig/lag_plot.png b/doc/source/savefig/lag_plot.png
new file mode 100644
index 0000000000000..26106ee864361
Binary files /dev/null and b/doc/source/savefig/lag_plot.png differ
diff --git a/doc/source/savefig/line_plot_table_data.png b/doc/source/savefig/line_plot_table_data.png
new file mode 100644
index 0000000000000..d86657301c3cc
Binary files /dev/null and b/doc/source/savefig/line_plot_table_data.png differ
diff --git a/doc/source/savefig/line_plot_table_describe.png b/doc/source/savefig/line_plot_table_describe.png
new file mode 100644
index 0000000000000..3186bf97dfc70
Binary files /dev/null and b/doc/source/savefig/line_plot_table_describe.png differ
diff --git a/doc/source/savefig/line_plot_table_true.png b/doc/source/savefig/line_plot_table_true.png
new file mode 100644
index 0000000000000..4f68c892c0723
Binary files /dev/null and b/doc/source/savefig/line_plot_table_true.png differ
diff --git a/doc/source/savefig/merge_on_index_and_column.png b/doc/source/savefig/merge_on_index_and_column.png
new file mode 100644
index 0000000000000..718e7d005fb5d
Binary files /dev/null and b/doc/source/savefig/merge_on_index_and_column.png differ
diff --git a/doc/source/savefig/merging_append1.png b/doc/source/savefig/merging_append1.png
new file mode 100644
index 0000000000000..957f71e72ea1c
Binary files /dev/null and b/doc/source/savefig/merging_append1.png differ
diff --git a/doc/source/savefig/merging_append2.png b/doc/source/savefig/merging_append2.png
new file mode 100644
index 0000000000000..a92fa6b83de3b
Binary files /dev/null and b/doc/source/savefig/merging_append2.png differ
diff --git a/doc/source/savefig/merging_append3.png b/doc/source/savefig/merging_append3.png
new file mode 100644
index 0000000000000..6e834e122738c
Binary files /dev/null and b/doc/source/savefig/merging_append3.png differ
diff --git a/doc/source/savefig/merging_append_dits.png b/doc/source/savefig/merging_append_dits.png
new file mode 100644
index 0000000000000..5bfd5054a0b1f
Binary files /dev/null and b/doc/source/savefig/merging_append_dits.png differ
diff --git a/doc/source/savefig/merging_append_ignore_index.png b/doc/source/savefig/merging_append_ignore_index.png
new file mode 100644
index 0000000000000..4cf99ff1ee769
Binary files /dev/null and b/doc/source/savefig/merging_append_ignore_index.png differ
diff --git a/doc/source/savefig/merging_append_series_as_row.png b/doc/source/savefig/merging_append_series_as_row.png
new file mode 100644
index 0000000000000..eb9dd3e5a28a6
Binary files /dev/null and b/doc/source/savefig/merging_append_series_as_row.png differ
diff --git a/doc/source/savefig/merging_combine_first.png b/doc/source/savefig/merging_combine_first.png
new file mode 100644
index 0000000000000..9485bbfb0cc40
Binary files /dev/null and b/doc/source/savefig/merging_combine_first.png differ
diff --git a/doc/source/savefig/merging_concat_axis1.png b/doc/source/savefig/merging_concat_axis1.png
new file mode 100644
index 0000000000000..75ab086a257c0
Binary files /dev/null and b/doc/source/savefig/merging_concat_axis1.png differ
diff --git a/doc/source/savefig/merging_concat_axis1_inner.png b/doc/source/savefig/merging_concat_axis1_inner.png
new file mode 100644
index 0000000000000..083dc83dd71b1
Binary files /dev/null and b/doc/source/savefig/merging_concat_axis1_inner.png differ
diff --git a/doc/source/savefig/merging_concat_axis1_join_axes.png b/doc/source/savefig/merging_concat_axis1_join_axes.png
new file mode 100644
index 0000000000000..f54b61f19b932
Binary files /dev/null and b/doc/source/savefig/merging_concat_axis1_join_axes.png differ
diff --git a/doc/source/savefig/merging_concat_basic.png b/doc/source/savefig/merging_concat_basic.png
new file mode 100644
index 0000000000000..6e834e122738c
Binary files /dev/null and b/doc/source/savefig/merging_concat_basic.png differ
diff --git a/doc/source/savefig/merging_concat_dict.png b/doc/source/savefig/merging_concat_dict.png
new file mode 100644
index 0000000000000..9f254786a2c38
Binary files /dev/null and b/doc/source/savefig/merging_concat_dict.png differ
diff --git a/doc/source/savefig/merging_concat_dict_keys.png b/doc/source/savefig/merging_concat_dict_keys.png
new file mode 100644
index 0000000000000..70be22407ce6a
Binary files /dev/null and b/doc/source/savefig/merging_concat_dict_keys.png differ
diff --git a/doc/source/savefig/merging_concat_dict_keys_names.png b/doc/source/savefig/merging_concat_dict_keys_names.png
new file mode 100644
index 0000000000000..9f254786a2c38
Binary files /dev/null and b/doc/source/savefig/merging_concat_dict_keys_names.png differ
diff --git a/doc/source/savefig/merging_concat_group_keys2.png b/doc/source/savefig/merging_concat_group_keys2.png
new file mode 100644
index 0000000000000..9f254786a2c38
Binary files /dev/null and b/doc/source/savefig/merging_concat_group_keys2.png differ
diff --git a/doc/source/savefig/merging_concat_ignore_index.png b/doc/source/savefig/merging_concat_ignore_index.png
new file mode 100644
index 0000000000000..4cf99ff1ee769
Binary files /dev/null and b/doc/source/savefig/merging_concat_ignore_index.png differ
diff --git a/doc/source/savefig/merging_concat_keys.png b/doc/source/savefig/merging_concat_keys.png
new file mode 100644
index 0000000000000..9f254786a2c38
Binary files /dev/null and b/doc/source/savefig/merging_concat_keys.png differ
diff --git a/doc/source/savefig/merging_concat_mixed_ndim.png b/doc/source/savefig/merging_concat_mixed_ndim.png
new file mode 100644
index 0000000000000..79d9f481f84ab
Binary files /dev/null and b/doc/source/savefig/merging_concat_mixed_ndim.png differ
diff --git a/doc/source/savefig/merging_concat_series_ignore_index.png b/doc/source/savefig/merging_concat_series_ignore_index.png
new file mode 100644
index 0000000000000..b260140f25e7c
Binary files /dev/null and b/doc/source/savefig/merging_concat_series_ignore_index.png differ
diff --git a/doc/source/savefig/merging_concat_unnamed_series.png b/doc/source/savefig/merging_concat_unnamed_series.png
new file mode 100644
index 0000000000000..9b6e7f64d5b9e
Binary files /dev/null and b/doc/source/savefig/merging_concat_unnamed_series.png differ
diff --git a/doc/source/savefig/merging_join.png b/doc/source/savefig/merging_join.png
new file mode 100644
index 0000000000000..34d8c5ea42255
Binary files /dev/null and b/doc/source/savefig/merging_join.png differ
diff --git a/doc/source/savefig/merging_join_inner.png b/doc/source/savefig/merging_join_inner.png
new file mode 100644
index 0000000000000..e0daad2942d07
Binary files /dev/null and b/doc/source/savefig/merging_join_inner.png differ
diff --git a/doc/source/savefig/merging_join_key_columns.png b/doc/source/savefig/merging_join_key_columns.png
new file mode 100644
index 0000000000000..ab961749f50c1
Binary files /dev/null and b/doc/source/savefig/merging_join_key_columns.png differ
diff --git a/doc/source/savefig/merging_join_multi_df.png b/doc/source/savefig/merging_join_multi_df.png
new file mode 100644
index 0000000000000..a8d2a43de48cc
Binary files /dev/null and b/doc/source/savefig/merging_join_multi_df.png differ
diff --git a/doc/source/savefig/merging_join_multiindex_inner.png b/doc/source/savefig/merging_join_multiindex_inner.png
new file mode 100644
index 0000000000000..3773cefb96d65
Binary files /dev/null and b/doc/source/savefig/merging_join_multiindex_inner.png differ
diff --git a/doc/source/savefig/merging_join_multikeys.png b/doc/source/savefig/merging_join_multikeys.png
new file mode 100644
index 0000000000000..5cb9286f211d4
Binary files /dev/null and b/doc/source/savefig/merging_join_multikeys.png differ
diff --git a/doc/source/savefig/merging_join_multikeys_inner.png b/doc/source/savefig/merging_join_multikeys_inner.png
new file mode 100644
index 0000000000000..80f9a980e10de
Binary files /dev/null and b/doc/source/savefig/merging_join_multikeys_inner.png differ
diff --git a/doc/source/savefig/merging_join_outer.png b/doc/source/savefig/merging_join_outer.png
new file mode 100644
index 0000000000000..da30484e83d54
Binary files /dev/null and b/doc/source/savefig/merging_join_outer.png differ
diff --git a/doc/source/savefig/merging_merge_index_inner.png b/doc/source/savefig/merging_merge_index_inner.png
new file mode 100644
index 0000000000000..e0daad2942d07
Binary files /dev/null and b/doc/source/savefig/merging_merge_index_inner.png differ
diff --git a/doc/source/savefig/merging_merge_index_outer.png b/doc/source/savefig/merging_merge_index_outer.png
new file mode 100644
index 0000000000000..da30484e83d54
Binary files /dev/null and b/doc/source/savefig/merging_merge_index_outer.png differ
diff --git a/doc/source/savefig/merging_merge_key_columns.png b/doc/source/savefig/merging_merge_key_columns.png
new file mode 100644
index 0000000000000..ab961749f50c1
Binary files /dev/null and b/doc/source/savefig/merging_merge_key_columns.png differ
diff --git a/doc/source/savefig/merging_merge_multiindex_alternative.png b/doc/source/savefig/merging_merge_multiindex_alternative.png
new file mode 100644
index 0000000000000..3773cefb96d65
Binary files /dev/null and b/doc/source/savefig/merging_merge_multiindex_alternative.png differ
diff --git a/doc/source/savefig/merging_merge_on_key.png b/doc/source/savefig/merging_merge_on_key.png
new file mode 100644
index 0000000000000..f1dded1b3f376
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_dup.png b/doc/source/savefig/merging_merge_on_key_dup.png
new file mode 100644
index 0000000000000..9d222ab642928
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_dup.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_inner.png b/doc/source/savefig/merging_merge_on_key_inner.png
new file mode 100644
index 0000000000000..2af4126c77e3a
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_inner.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_left.png b/doc/source/savefig/merging_merge_on_key_left.png
new file mode 100644
index 0000000000000..f580debd78a74
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_left.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_multiple.png b/doc/source/savefig/merging_merge_on_key_multiple.png
new file mode 100644
index 0000000000000..2af4126c77e3a
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_multiple.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_outer.png b/doc/source/savefig/merging_merge_on_key_outer.png
new file mode 100644
index 0000000000000..6ef2f7fdf13a4
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_outer.png differ
diff --git a/doc/source/savefig/merging_merge_on_key_right.png b/doc/source/savefig/merging_merge_on_key_right.png
new file mode 100644
index 0000000000000..47d8c441f532c
Binary files /dev/null and b/doc/source/savefig/merging_merge_on_key_right.png differ
diff --git a/doc/source/savefig/merging_merge_overlapped.png b/doc/source/savefig/merging_merge_overlapped.png
new file mode 100644
index 0000000000000..3b57f2f2ee8b4
Binary files /dev/null and b/doc/source/savefig/merging_merge_overlapped.png differ
diff --git a/doc/source/savefig/merging_merge_overlapped_multi_suffix.png b/doc/source/savefig/merging_merge_overlapped_multi_suffix.png
new file mode 100644
index 0000000000000..8b9c70ae411ca
Binary files /dev/null and b/doc/source/savefig/merging_merge_overlapped_multi_suffix.png differ
diff --git a/doc/source/savefig/merging_merge_overlapped_suffix.png b/doc/source/savefig/merging_merge_overlapped_suffix.png
new file mode 100644
index 0000000000000..d4660ae0e7c1a
Binary files /dev/null and b/doc/source/savefig/merging_merge_overlapped_suffix.png differ
diff --git a/doc/source/savefig/merging_merge_two_multiindex.png b/doc/source/savefig/merging_merge_two_multiindex.png
new file mode 100644
index 0000000000000..71697ad9085ca
Binary files /dev/null and b/doc/source/savefig/merging_merge_two_multiindex.png differ
diff --git a/doc/source/savefig/merging_update.png b/doc/source/savefig/merging_update.png
new file mode 100644
index 0000000000000..a33180708b1dd
Binary files /dev/null and b/doc/source/savefig/merging_update.png differ
diff --git a/doc/source/savefig/parallel_coordinates.png b/doc/source/savefig/parallel_coordinates.png
new file mode 100644
index 0000000000000..7196ec930eb22
Binary files /dev/null and b/doc/source/savefig/parallel_coordinates.png differ
diff --git a/doc/source/savefig/parallel_gist_rainbow.png b/doc/source/savefig/parallel_gist_rainbow.png
new file mode 100644
index 0000000000000..666cbd5d3d664
Binary files /dev/null and b/doc/source/savefig/parallel_gist_rainbow.png differ
diff --git a/doc/source/savefig/quartile_boxplot.png b/doc/source/savefig/quartile_boxplot.png
new file mode 100644
index 0000000000000..280d4677090f6
Binary files /dev/null and b/doc/source/savefig/quartile_boxplot.png differ
diff --git a/doc/source/savefig/radviz.png b/doc/source/savefig/radviz.png
new file mode 100644
index 0000000000000..fb4edde2295a9
Binary files /dev/null and b/doc/source/savefig/radviz.png differ
diff --git a/doc/source/savefig/rolling_apply_ex.png b/doc/source/savefig/rolling_apply_ex.png
new file mode 100644
index 0000000000000..a95f6689e63fb
Binary files /dev/null and b/doc/source/savefig/rolling_apply_ex.png differ
diff --git a/doc/source/savefig/rolling_corr_pairwise_ex.png b/doc/source/savefig/rolling_corr_pairwise_ex.png
new file mode 100644
index 0000000000000..6d1af8f80e888
Binary files /dev/null and b/doc/source/savefig/rolling_corr_pairwise_ex.png differ
diff --git a/doc/source/savefig/rolling_mean_ex.png b/doc/source/savefig/rolling_mean_ex.png
new file mode 100644
index 0000000000000..83a027bfe1c85
Binary files /dev/null and b/doc/source/savefig/rolling_mean_ex.png differ
diff --git a/doc/source/savefig/rolling_mean_frame.png b/doc/source/savefig/rolling_mean_frame.png
new file mode 100644
index 0000000000000..291c674b5440c
Binary files /dev/null and b/doc/source/savefig/rolling_mean_frame.png differ
diff --git a/doc/source/savefig/scatter_matrix_kde.png b/doc/source/savefig/scatter_matrix_kde.png
new file mode 100644
index 0000000000000..fb0233f022017
Binary files /dev/null and b/doc/source/savefig/scatter_matrix_kde.png differ
diff --git a/doc/source/savefig/scatter_plot.png b/doc/source/savefig/scatter_plot.png
new file mode 100644
index 0000000000000..797d1e551b6e1
Binary files /dev/null and b/doc/source/savefig/scatter_plot.png differ
diff --git a/doc/source/savefig/scatter_plot_bubble.png b/doc/source/savefig/scatter_plot_bubble.png
new file mode 100644
index 0000000000000..965332e730d02
Binary files /dev/null and b/doc/source/savefig/scatter_plot_bubble.png differ
diff --git a/doc/source/savefig/scatter_plot_colored.png b/doc/source/savefig/scatter_plot_colored.png
new file mode 100644
index 0000000000000..df7e7ecbfd7cd
Binary files /dev/null and b/doc/source/savefig/scatter_plot_colored.png differ
diff --git a/doc/source/savefig/scatter_plot_repeated.png b/doc/source/savefig/scatter_plot_repeated.png
new file mode 100644
index 0000000000000..a99a1753fb73b
Binary files /dev/null and b/doc/source/savefig/scatter_plot_repeated.png differ
diff --git a/doc/source/savefig/ser_plot_suppress.png b/doc/source/savefig/ser_plot_suppress.png
new file mode 100644
index 0000000000000..c04ce591d6226
Binary files /dev/null and b/doc/source/savefig/ser_plot_suppress.png differ
diff --git a/doc/source/savefig/ser_plot_suppress_context.png b/doc/source/savefig/ser_plot_suppress_context.png
new file mode 100644
index 0000000000000..7e54c81ae42b6
Binary files /dev/null and b/doc/source/savefig/ser_plot_suppress_context.png differ
diff --git a/doc/source/savefig/ser_plot_suppress_parm.png b/doc/source/savefig/ser_plot_suppress_parm.png
new file mode 100644
index 0000000000000..8ffa0c4795a91
Binary files /dev/null and b/doc/source/savefig/ser_plot_suppress_parm.png differ
diff --git a/doc/source/savefig/series_interpolate.png b/doc/source/savefig/series_interpolate.png
new file mode 100644
index 0000000000000..c4d6afecae77e
Binary files /dev/null and b/doc/source/savefig/series_interpolate.png differ
diff --git a/doc/source/savefig/series_pie_plot.png b/doc/source/savefig/series_pie_plot.png
new file mode 100644
index 0000000000000..48c3dc9f0deba
Binary files /dev/null and b/doc/source/savefig/series_pie_plot.png differ
diff --git a/doc/source/savefig/series_pie_plot_options.png b/doc/source/savefig/series_pie_plot_options.png
new file mode 100644
index 0000000000000..63d9885d7bc75
Binary files /dev/null and b/doc/source/savefig/series_pie_plot_options.png differ
diff --git a/doc/source/savefig/series_pie_plot_semi.png b/doc/source/savefig/series_pie_plot_semi.png
new file mode 100644
index 0000000000000..205d7a7c352f0
Binary files /dev/null and b/doc/source/savefig/series_pie_plot_semi.png differ
diff --git a/doc/source/savefig/series_plot_basic.png b/doc/source/savefig/series_plot_basic.png
new file mode 100644
index 0000000000000..a556db092e5ca
Binary files /dev/null and b/doc/source/savefig/series_plot_basic.png differ
diff --git a/doc/source/savefig/series_plot_basic2.png b/doc/source/savefig/series_plot_basic2.png
new file mode 100644
index 0000000000000..34728610d62ab
Binary files /dev/null and b/doc/source/savefig/series_plot_basic2.png differ
diff --git a/doc/source/savefig/series_plot_logy.png b/doc/source/savefig/series_plot_logy.png
new file mode 100644
index 0000000000000..2e62090cacd68
Binary files /dev/null and b/doc/source/savefig/series_plot_logy.png differ
diff --git a/doc/source/savefig/series_plot_multi.png b/doc/source/savefig/series_plot_multi.png
new file mode 100644
index 0000000000000..e8aea13795a91
Binary files /dev/null and b/doc/source/savefig/series_plot_multi.png differ
diff --git a/doc/source/savefig/series_plot_secondary_y.png b/doc/source/savefig/series_plot_secondary_y.png
new file mode 100644
index 0000000000000..71848f9d384de
Binary files /dev/null and b/doc/source/savefig/series_plot_secondary_y.png differ
diff --git a/doc/test.json b/doc/test.json
new file mode 100644
index 0000000000000..10510563cb713
--- /dev/null
+++ b/doc/test.json
@@ -0,0 +1 @@
+{"schema": {"fields":[{"name":"index","type":"integer"},{"name":"bar","type":"string"},{"name":"baz","type":"datetime"},{"name":"foo","type":"integer"},{"name":"qux","type":"any","constraints":{"enum":["a","b","c"]},"ordered":false}],"primaryKey":["index"],"pandas_version":"0.20.0"}, "data": [{"index":0,"bar":"a","baz":"2018-01-01T00:00:00.000Z","foo":1,"qux":"a"},{"index":1,"bar":"b","baz":"2018-01-02T00:00:00.000Z","foo":2,"qux":"b"},{"index":2,"bar":"c","baz":"2018-01-03T00:00:00.000Z","foo":3,"qux":"c"},{"index":3,"bar":"d","baz":"2018-01-04T00:00:00.000Z","foo":4,"qux":"c"}]}
\ No newline at end of file


Code review comments:
diff_hunk: @@ -246,6 +246,24 @@ Testing
 
    test
 
+.. currentmodule:: pandas.plotting
+
+Plotting
+--------
path: doc/source/api.rst
text: @user1:
Can you move this section more to the bottom? There is already a small section on plotting that includes `(de)register_matplotlib_converters`, so you can merge both

@author:
@user1 Sure thing! Thanks for the feedback. Would it matter if I just did this in a new branch? I'm having trouble crafting the right git command that will un-commit and unstage my changes. Or is it preferred I keep everything on this branch? Or should I just put it in master?

@user1:
Normally you should be able to do `git rm doc/source/savefig/*` and commit those changes. No need to un-commit the previous one (we will squash all commits into one in the end anyway). 


@user1:
So if that works, we would prefer that you further push to this branch / PR.

@author:
Got it. I'll do that now.