Skip to content

Commit 92c3621

Browse files
committed
Post: small post about "latest core requirements"
Announce the changes made at readthedocs/readthedocs.org#10508 Note that we are not exposing this feature flag to our users. We don't want them to contact us to enable this flag. If they need to install the latest versions they can just specify them in their `requirements.txt` file.
1 parent f29749b commit 92c3621

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

python-core-requirements-changed.rst

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
.. post:: July 7, 2023
2+
:tags: builders
3+
:author: Manuel
4+
:location: BCN
5+
:category: Changelog
6+
7+
Python "core requirements" installed by default have changed
8+
============================================================
9+
10+
Starting on **August 7, 2023** all new projects imported on Read the Docs
11+
will install only ``sphinx``, ``mkdocs`` and ``readthedocs-sphinx-ext`` as "core requirements".
12+
Besides, the new behavior will install the latest version of these requirements.
13+
14+
Note that previously Read the Docs was installing also
15+
``jinja``, ``sphinx-rtd-theme``, ``pillow``, ``mock``, ``alabaster``, ``commonmark`` and ``recommonmark``
16+
specifying particular versions depending on different factors that were confusing for users and hard to debug.
17+
18+
We are moving away from executing commands and installing dependencies on behalf of the users
19+
and trying to make the build experience on Read the Docs the same as building locally,
20+
without surprises.
21+
22+
Projects imported previous to August 7, 2023 will keep the actual behavior and won't be affected by this change.
23+
If you have a project you want to install the latest version of these requirements,
24+
you can use a ``requirements.txt`` file to specify their versions.
25+
Read more about :doc:`how to use a requirements.txt file in our documentation <readthedocs:config-file/v2>`.

0 commit comments

Comments
 (0)