DOC improve the UG documentation of the classification report (scikit…

…-learn-contrib#868)

Co-authored-by: Guillaume Lemaitre <[email protected]>

doc/metrics.rst

@@ -65,10 +65,16 @@ each class and averaged over classes, giving an equal weight to each class.
 Summary of important metrics
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The :func:`classification_report_imbalanced` will compute a set of metrics
-per class and summarize it in a table. The parameter `output_dict` allows
-to get a string or a Python dictionary. This dictionary can be reused to create
-a Pandas dataframe for instance.
+The :func:`classification_report_imbalanced` will compute a set of metrics per
+class and summarize it in a table. The parameter `output_dict` allows to get a
+string or a Python dictionary. This dictionary can be reused to create a Pandas
+dataframe for instance.
+
+The bottom row (i.e "avg/total") contains the weighted average by the support
+(i.e column "sup") of each column.
+
+Note that the weighted average of the class recalls is also known as the
+classification accuracy.
 
 .. _pairwise_metrics: