pvlib · aman-coder03 · Feb 6, 2026
diff --git a/...e-transposition/plot_ghi_transposition.py → ...nce-transposition/01_ghi_transposition.py b/...e-transposition/plot_ghi_transposition.py → ...nce-transposition/01_ghi_transposition.py
diff --git a/...-transposition/plot_transposition_gain.py → ...ce-transposition/02_transposition_gain.py b/...-transposition/plot_transposition_gain.py → ...ce-transposition/02_transposition_gain.py
diff --git a/...tion/plot_interval_transposition_error.py → ...sition/03_interval_transposition_error.py b/...tion/plot_interval_transposition_error.py → ...sition/03_interval_transposition_error.py
diff --git a/...nce-transposition/use_perez_modelchain.py → ...-transposition/04_use_perez_modelchain.py b/...nce-transposition/use_perez_modelchain.py → ...-transposition/04_use_perez_modelchain.py
diff --git a/...e-transposition/plot_mixed_orientation.py → ...nce-transposition/05_mixed_orientation.py b/...e-transposition/plot_mixed_orientation.py → ...nce-transposition/05_mixed_orientation.py
diff --git a/...iance-transposition/plot_seasonal_tilt.py → ...adiance-transposition/06_seasonal_tilt.py b/...iance-transposition/plot_seasonal_tilt.py → ...adiance-transposition/06_seasonal_tilt.py
diff --git a/...ance-transposition/plot_rtranpose_year.py → ...iance-transposition/07_rtranspose_year.py b/...ance-transposition/plot_rtranpose_year.py → ...iance-transposition/07_rtranspose_year.py
diff --git a/...ansposition/plot_rtranpose_limitations.py → ...ransposition/08_rtranspose_limitations.py b/...ansposition/plot_rtranpose_limitations.py → ...ransposition/08_rtranspose_limitations.py
diff --git a/docs/sphinx/source/contributing/style_guide.rst b/docs/sphinx/source/contributing/style_guide.rst
@@ -350,3 +350,15 @@ Here is a starter template for new examples:
 
 For more details, see the sphinx-gallery
 `docs <https://sphinx-gallery.github.io/stable/syntax.html#embedding-rst>`_.
+
+Controlling Example Order
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Examples within a subsection are ordered alphabetically by filename.
+To control their position explicitly, prefix filenames with numbers
+(e.g., ``01_``, ``02_``).
+
+For more advanced ordering options, see the sphinx-gallery
+`documentation <https://sphinx-gallery.github.io/stable/configuration.html#own-sort-keys>`_.
+
+