Merge pull request #29767 from QianZhang19/logit_demo_descri

QianZhang19 · web-flow · commit f1e7d3b096d1 · 2025-03-18T15:11:23.000+01:00
Add description to logit_demo.py script
diff --git a/galleries/examples/scales/logit_demo.py b/galleries/examples/scales/logit_demo.py
@@ -4,6 +4,20 @@
 ===========
 
 Examples of plots with logit axes.
+
+This example visualises how ``set_yscale("logit")`` works on probability plots
+by generating three distributions: normal, laplacian, and cauchy in one plot.
+
+The advantage of logit scale is that it effectively spreads out values close to 0 and 1.
+
+In a linear scale plot, probability values near 0 and 1 appear compressed,
+making it difficult to see differences in those regions.
+
+In a logit scale plot, the transformation expands these regions,
+making the graph cleaner and easier to compare across different probability values.
+
+This makes the logit scale especially useful when visalising probabilities in logistic
+regression, classification models, and cumulative distribution functions.
 """
 
 import math
