new troubleshooting page specific to development

story645 · story645 · commit c1191d7db0de · 2023-08-30T23:54:49.000-04:00
diff --git a/doc/devel/troubleshooting.rst b/doc/devel/troubleshooting.rst
@@ -0,0 +1,35 @@
+.. _troubleshooting-faq:
+
+.. redirect-from:: /faq/troubleshooting_faq
+.. redirect-from:: users/faq/troubleshooting_faq
+
+===============
+Troubleshooting
+===============
+
+.. install/config/versioning troubleshooting
+.. include:: /users/installing/troubleshooting_faq.inc.rst
+
+.. _git-trouble:
+
+Problems with git
+=================
+
+First, make sure you have a clean build and install (see :ref:`clean-install`),
+get the latest git update, install it and run a simple test script in debug
+mode::
+
+    rm -rf /path/to/site-packages/matplotlib*
+    git clean -xfd
+    git pull
+    python -m pip install -v . > build.out
+    python -c "from pylab import *; set_loglevel('debug'); plot(); show()" > run.out
+
+and post :file:`build.out` and :file:`run.out` to the `matplotlib-devel
+<https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
+mailing list (please do not post git problems to the `users list
+<https://mail.python.org/mailman/listinfo/matplotlib-users>`_).
+
+Of course, you will want to clearly describe your problem, what you
+are expecting and what you are getting, but often a clean build and
+install will help.  See also :ref:`reporting-problems`.
