diff --git a/doc/devel/color_changes.rst b/doc/devel/color_changes.rst
index 24aa15f29abf..f7646ded7c14 100644
--- a/doc/devel/color_changes.rst
+++ b/doc/devel/color_changes.rst
@@ -4,7 +4,8 @@
Default color changes
*********************
-As discussed at length elsewhere [insert links], ``jet`` is an
+As discussed at length `elsewhere `__ ,
+``jet`` is an
empirically bad colormap and should not be the default colormap.
Due to the position that changing the appearance of the plot breaks
backward compatibility, this change has been put off for far longer
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
index 5023a7ecb640..28faf61f0771 100644
--- a/doc/devel/contributing.rst
+++ b/doc/devel/contributing.rst
@@ -289,6 +289,12 @@ API consistency and stability are of great value. Therefore, API changes
(e.g. signature changes, behavior changes, removals) will only be conducted
if the added benefit is worth the user effort for adapting.
+Because we are a visualization library our primary output is the final
+visualization the user sees. Thus it is our :ref:`long standing
+` policy that the appearance of the figure is part of the API
+and any changes, either semantic or esthetic, will be treated as a
+backwards-incompatible API change.
+
API changes in Matplotlib have to be performed following the deprecation process
below, except in very rare circumstances as deemed necessary by the development team.
This ensures that users are notified before the change will take effect and thus
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy