Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Post: small post about "latest core requirements" #226

Merged
merged 3 commits into from
Jul 10, 2023
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions python-core-requirements-changed.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
.. post:: July 7, 2023
:tags: builders
:author: Manuel
:location: BCN
:category: Changelog

Python "core requirements" for new projects will install latest version
=======================================================================

Starting on **August 7, 2023** all new projects imported on Read the Docs
will install only ``sphinx``, ``mkdocs`` and ``readthedocs-sphinx-ext`` as "core requirements".
The default behavior will be to install the latest version of these requirements.

Note that previously Read the Docs was installing also
``jinja``, ``sphinx-rtd-theme``, ``pillow``, ``mock``, ``alabaster``, ``commonmark`` and ``recommonmark``
specifying particular versions depending on different factors that were confusing for users and hard to debug.

We are moving away from executing commands and installing dependencies on behalf of the users
and trying to make the build experience on Read the Docs the same as building locally,
without surprises.

Projects imported before August 7, 2023 will keep the existing behavior and won't be affected by this change.
If you have a project you want to install the latest version of these requirements,
you can use a ``requirements.txt`` file to specify their versions, or no version to automatically install the latest version.
Read more about :doc:`how to use a requirements.txt file in our documentation <readthedocs:config-file/v2>`.