From 3785b97d90ad8f80f542d4895bef1ba7ae04c420 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Tue, 1 Aug 2023 16:39:25 +0200 Subject: [PATCH 1/3] Post: Use `build.os` instead of `build.image` Announcement for https://github.com/readthedocs/readthedocs.org/pull/10589 --- use-build-os-config.rst | 57 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 use-build-os-config.rst diff --git a/use-build-os-config.rst b/use-build-os-config.rst new file mode 100644 index 0000000..d525d0e --- /dev/null +++ b/use-build-os-config.rst @@ -0,0 +1,57 @@ +.. post:: August 7, 2023 + :tags: builders, deprecation + :author: Manuel + :location: BCN + :category: Changelog + + +Use ``build.os`` instead of ``build.image`` on your configuration file +====================================================================== + +We are announcing the deprecation of ``build.image`` config key in favor of ``build.os``. +Read the Docs *will start requiring* a ``build.os`` config key for all projects in order to build documentation successfully. +**We will start failing builds using "build.image" on their config file on October 16, 2023**. + + +Deprecation timeline +-------------------- + +We understand this change will affect many of our users, +so we have a timeline to communicate this deprecation to our users effectively. + +* **Monday, August 28, 2023**: Do the first brownout (temporarily enforce this deprecation) for 12 hours: 00:01 PST to 11:59 PST (noon) +* **Monday, September 18, 2023**: Do a second brownout (temporarily enforce this deprecation) for 24 hours: 00:01 PST to 23:59 PST (midnight) +* **Monday, October 2, 2023**: Do a third and final brownout (temporarily enforce this deprecation) for 48 hours: 00:01 PST to October 3, 2023 23:59 PST (midnight) +* **Monday, October 16, 2023**: Fully remove support for building documentation using "build.image" on the configuration file + + +Migrating to ``build.os`` +------------------------- + +If you have a project on Read the Docs that is using ``build.image``, +**you will need to migrate to the new config key as soon as possible** to continue building your project. + +There are some small differences between ``build.image`` and ``build.os`` that we detail here: + +- ``version: 2`` must be used with ``build.os`` +- To specify the Python version, you have to use ``build.tools.python`` + +Below is shown how the ``build`` config key section would be after applying these changes. +Make sure to make these changes before October 16, 2023. + +.. code:: yaml + + version: 2 + build: + os: "ubuntu-22.04" + tools: + python: "3.11" + + +Contact us +---------- + +`Contact us`_ if you have any questions, +and let us know if you are having trouble using a this new config key for any reason. + +.. _Contact us: https://readthedocs.org/support/ From 17c46ba7983143a6c548ebbabeb349c9b5842261 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Tue, 8 Aug 2023 17:11:01 +0200 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com> --- use-build-os-config.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/use-build-os-config.rst b/use-build-os-config.rst index d525d0e..2fbec11 100644 --- a/use-build-os-config.rst +++ b/use-build-os-config.rst @@ -36,8 +36,9 @@ There are some small differences between ``build.image`` and ``build.os`` that w - ``version: 2`` must be used with ``build.os`` - To specify the Python version, you have to use ``build.tools.python`` -Below is shown how the ``build`` config key section would be after applying these changes. -Make sure to make these changes before October 16, 2023. +Below is an example of a valid ``build`` section of your configuration. +Make sure to make these changes before **October 16, 2023**: + .. code:: yaml @@ -47,6 +48,7 @@ Make sure to make these changes before October 16, 2023. tools: python: "3.11" +You can read about the ``build.os`` key, including all possible values, in our `"build.os" documentation `_. Contact us ---------- From 6aac25164c5947d0615d5d5c437afc94b12fa1f5 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Tue, 8 Aug 2023 17:32:21 +0200 Subject: [PATCH 3/3] Update date --- use-build-os-config.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/use-build-os-config.rst b/use-build-os-config.rst index d525d0e..d6ce5b4 100644 --- a/use-build-os-config.rst +++ b/use-build-os-config.rst @@ -1,4 +1,4 @@ -.. post:: August 7, 2023 +.. post:: August 9, 2023 :tags: builders, deprecation :author: Manuel :location: BCN