From 10d3f950575cf689a031d62abae886fb1f4b90bb Mon Sep 17 00:00:00 2001 From: Anthony Johnson Date: Fri, 11 Jan 2019 17:26:18 -0700 Subject: [PATCH 1/4] Post on defaulting to Python 3 We're not yet ready for this to be merged, we have some final pieces and a release of our docker image to perform before going official with this. --- default-python-3.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 default-python-3.rst diff --git a/default-python-3.rst b/default-python-3.rst new file mode 100644 index 00000000..9fcb200e --- /dev/null +++ b/default-python-3.rst @@ -0,0 +1,14 @@ +.. post:: Jan 11th, 2019 + :author: Anthony + +Defaulting to Python 3 +====================== + +Starting February 1st, 2019, new projects getting started with Read the Docs +will use Python 3 by default. While it is stil possible to configure your +project to use Python 2.7 with :ref:`our config file `, +we think it's important for the ecosystem to help push projects towards adopting +Python 3. + +For the time being, Python 3.6 will be our default Python 3 version, however we +will have Python 3.7 available for testing very shortly as well. From 9a1b231d1c046a8b9ff40a540009ce593611fd20 Mon Sep 17 00:00:00 2001 From: David Fischer Date: Thu, 17 Jan 2019 15:00:50 -0700 Subject: [PATCH 2/4] Add python tag to post Co-Authored-By: agjohnson --- default-python-3.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/default-python-3.rst b/default-python-3.rst index 9fcb200e..73470312 100644 --- a/default-python-3.rst +++ b/default-python-3.rst @@ -1,5 +1,6 @@ .. post:: Jan 11th, 2019 :author: Anthony + :tags: python Defaulting to Python 3 ====================== From b3f27b031e0fbbf303cf66659a339ae340bd1e82 Mon Sep 17 00:00:00 2001 From: Anthony Johnson Date: Fri, 8 Feb 2019 14:07:54 -0700 Subject: [PATCH 3/4] Update post quite a bit, mention how to use 3.3 and 3.4 --- default-python-3.rst | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/default-python-3.rst b/default-python-3.rst index 73470312..d3028288 100644 --- a/default-python-3.rst +++ b/default-python-3.rst @@ -1,15 +1,27 @@ -.. post:: Jan 11th, 2019 +.. post:: Feb 8th, 2019 :author: Anthony :tags: python -Defaulting to Python 3 -====================== +Defaulting New Projects to Python 3 +=================================== -Starting February 1st, 2019, new projects getting started with Read the Docs -will use Python 3 by default. While it is stil possible to configure your -project to use Python 2.7 with :ref:`our config file `, -we think it's important for the ecosystem to help push projects towards adopting -Python 3. +New projects that are just getting started with Read the Docs will now use +Python 3 by default. While it is still possible to configure your project to use +Python 2.7 with :doc:`our configuration file `, we +think it's important to help push the Python ecosystem towards adopting Python 3. -For the time being, Python 3.6 will be our default Python 3 version, however we -will have Python 3.7 available for testing very shortly as well. +Our default Python version is currently Python 3.7. Projects can also select +Python versions 3.6 and 3.5 using our default build image. We will eventually +remove support for building projects with Python versions 3.3 and 3.4, however +it is still possible to select a build image with support for either version. + +To select a specific version of Python, other than our default, you can use our +configuration file to specify a Python version, using the +:ref:`readthedocs:config-file/v2:python.version` configuration option. + +If your project does require Python version 3.3 or 3.4, you can only select +these versions if you also specify ``stable`` build image for your project's +:ref:`readthedocs:config-file/v2:build.image` configuration option. As we +release new versions of our build image, this ``stable`` image will eventually +lose support for Python 3.3 and 3.4, so it's suggested that your project upgrade +to a supported version of Python. From a40f782a8422574e76aeb738c0cfb45a3f3957e2 Mon Sep 17 00:00:00 2001 From: Eric Holscher <25510+ericholscher@users.noreply.github.com> Date: Tue, 12 Feb 2019 10:09:56 -0300 Subject: [PATCH 4/4] Update date --- default-python-3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/default-python-3.rst b/default-python-3.rst index d3028288..e61558e6 100644 --- a/default-python-3.rst +++ b/default-python-3.rst @@ -1,4 +1,4 @@ -.. post:: Feb 8th, 2019 +.. post:: Feb 12, 2019 :author: Anthony :tags: python