Document that the mpl-data directory is required

QuLogic · QuLogic · commit 89aeed61880b · 2021-11-09T00:40:26.000-05:00
See matplotlib#21375
diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/development.rst b/doc/api/prev_api_changes/api_changes_3.5.0/development.rst
@@ -39,6 +39,18 @@ The `setuptools-scm-git-archive
 <https://pypi.org/project/setuptools-scm-git-archive/>`__ plugin is also used
 for consistent version export.
 
+Data directory is no longer optional
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Historically, the ``mpl-data`` directory has been optional (example files were
+unnecessary, and fonts could be deleted if a suitable dependency on a system
+font were provided). Though example files are still optional, they have been
+substantially pared down, and we now consider the directory to be required.
+
+Specifically, the ``matplotlibrc`` file found there is used for runtime
+verifications and must exist. Packagers may still symlink fonts to system
+versions if needed.
+
 New runtime dependencies
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
