Merge pull request matplotlib#29768 from meeseeksmachine/auto-backport-of-pr-29767-on-v3.10.x

dstansby · web-flow · commit 90a5aa9eb5c9 · 2025-03-18T15:04:13.000Z
Backport PR matplotlib#29767 on branch v3.10.x (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
