Add clarification for MkDocs versioning
@@ -483,7 +483,7 @@ This means the build fails if there is a warning and exits with exit status 1.
mkdocs
~~~~~~
-Configuration for Mkdocs documentation.
+Configuration for MkDocs documentation.
.. code-block:: yaml
@@ -493,6 +493,13 @@ Configuration for Mkdocs documentation.
configuration: mkdocs.yml
fail_on_warning: false
+.. note::
+ If you want to pin MkDocs to a specific version,
+ use a ``requirements.txt`` or ``environment.yml`` file
+ (see :ref:`config-file/v2:requirements file` and :ref:`config-file/v2:conda.environment`).
+ This also allows you to override :ref:`the default pinning done by Read the Docs
+ if your project was created before March 2021 <builds:external dependencies>`.
+
mkdocs.configuration
````````````````````
