Backport PR #4056 on branch 1.12.x (docs: add inline example plot to sc.pl.pca_variance_ratio) (#4065)

Co-authored-by: Ekin Kahraman <evk23umu@uea.ac.uk>

Author: meeseeksmachine

src/scanpy/plotting/_tools/__init__.py

@@ -206,6 +206,24 @@ def pca_variance_ratio(
         A string is appended to the default filename.
         Infer the filetype if ending on {`'.pdf'`, `'.png'`, `'.svg'`}.
 
+    Examples
+    --------
+    Plot the variance ratio for the first 30 PCs.
+
+    .. plot::
+        :context: close-figs
+
+        import scanpy as sc
+        adata = sc.datasets.pbmc3k_processed()
+        sc.pl.pca_variance_ratio(adata)
+
+    Plot on a logarithmic scale.
+
+    .. plot::
+        :context: close-figs
+
+        sc.pl.pca_variance_ratio(adata, log=True)
+
     """
     ranking(
         adata,