From 9d09b437987b528685008c2bd3a89ff63fea1b1b Mon Sep 17 00:00:00 2001
From: Jaroslav Klech <jklech@redhat.com>
Date: Oct 10 2019 13:56:35 +0000
Subject: [PATCH 1/2] Describes issue#306


---

diff --git a/modules/release-notes/pages/developers/Development_Python.adoc b/modules/release-notes/pages/developers/Development_Python.adoc
index 9a2ac8c..b4551b9 100644
--- a/modules/release-notes/pages/developers/Development_Python.adoc
+++ b/modules/release-notes/pages/developers/Development_Python.adoc
@@ -3,3 +3,9 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-python]]
 = Python
+
+[[sphinx-dropped-support]]
+== Python 2 support was dropped from Sphinx
+
+The packages and sub-packages providing Python 2 support for Sphinx have been removed. See the xref:sysadmin/System_Utilities.adoc#sphinx-update[System Utilities section] for details.
+
diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc
index 2f57f6e..9e735d5 100644
--- a/modules/release-notes/pages/sysadmin/System_Utilities.adoc
+++ b/modules/release-notes/pages/sysadmin/System_Utilities.adoc
@@ -3,3 +3,24 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-system-utilities]]
 = System Utilities
+
+[[sphinx-update]]
+== Sphinx was updated to version 2 and dropped support for Python 2
+
+The `python-sphinx` package has been updated to version 2.0.x in Fedora 31. 
+
+Also the following Python 2 (sub)packages providing support to Sphinx have been removed:
+
+* `python2-sphinx`
+* `python2-catkin-sphinx`
+* `python2-numpydoc`
+* `python2-snowballstemmer`
+* `python2-sphinx-intl`
+* `python2-sphinx-theme-alabaster`
+* `python2-sphinx_rtd_theme`
+* `python2-sphinxcontrib-httpdomain`
+* `python2-sphinxcontrib-websupport`
+* `sphinx-webtools`
+* `trac-sphinx-plugin`
+
+

From 8a0ae16716c3237dff6ee595527ffdead2c3cebe Mon Sep 17 00:00:00 2001
From: Jaroslav Klech <jklech@redhat.com>
Date: Oct 10 2019 15:48:04 +0000
Subject: [PATCH 2/2] Applies SME feedback


---

diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc
index 9e735d5..1571f2e 100644
--- a/modules/release-notes/pages/sysadmin/System_Utilities.adoc
+++ b/modules/release-notes/pages/sysadmin/System_Utilities.adoc
@@ -7,7 +7,7 @@ include::{partialsdir}/entities.adoc[]
 [[sphinx-update]]
 == Sphinx was updated to version 2 and dropped support for Python 2
 
-The `python-sphinx` package has been updated to version 2.0.x in Fedora 31. 
+The `python-sphinx` package has been updated to version 2.x in Fedora 31. 
 
 Also the following Python 2 (sub)packages providing support to Sphinx have been removed:
 
@@ -23,4 +23,5 @@ Also the following Python 2 (sub)packages providing support to Sphinx have been 
 * `sphinx-webtools`
 * `trac-sphinx-plugin`
 
+Users who need to run Sphinx on Python 2 have to use Python virtual environment and the `pip` package manager. For more information, see this [citetitle]_link:++https://developer.fedoraproject.org/tech/languages/python/multiple-pythons.html++[Fedora Developer]_ page.