Switch docs building under Py3

Refs #53137

.ci/docs

@@ -27,8 +27,8 @@ pipeline {
                 sh '''
                 eval "$(pyenv init -)"
                 pyenv --version
-                pyenv install --skip-existing 2.7.15
+                pyenv install --skip-existing 3.6.8
-                pyenv shell 2.7.15
+                pyenv shell 3.6.8
                 python --version
                 pip install -U https://github.com/s0undt3ch/nox/archive/hotfix/py2.zip#egg=Nox==2018.10.17
                 nox --version
@@ -39,7 +39,7 @@ pipeline {
             steps {
                 sh '''
                 eval "$(pyenv init -)"
-                pyenv shell 2.7.15
+                pyenv shell 3.6.8
                 nox -e docs
                 '''
                 archiveArtifacts artifacts: 'doc/doc-archive.tar.gz'

.pre-commit-config.yaml

@@ -127,15 +127,6 @@ repos:
           - --py-version=2.7
           - --platform=linux
 
-      - id: pip-tools-compile
-        alias: compile-doc-requirements
-        name: Docs Py2.7 Requirements
-        files: ^requirements/((base|zeromq|pytest)\.txt|static/docs\.in)$
-        args:
-          - -v
-          - --py-version=2.7
-          - --platform=linux
-
       - id: pip-tools-compile
         alias: compile-cloud-py2.7-requirements
         name: Cloud Py2.7 Requirements
@@ -436,6 +427,15 @@ repos:
           - -v
           - --py-version=3.6
 
+      - id: pip-tools-compile
+        alias: compile-doc-requirements
+        name: Docs Py3.6 Requirements
+        files: ^requirements/((base|zeromq|pytest)\.txt|static/docs\.in)$
+        args:
+          - -v
+          - --py-version=3.6
+          - --platform=linux
+
       - id: pip-tools-compile
         alias: compile-linux-py3.7-tcp-requirements
         name: Linux Py3.7 TCP Requirements

noxfile.py

@@ -888,12 +888,12 @@ def lint_tests(session):
     _lint(session, '.testing.pylintrc', flags, paths)
 
 
-@nox.session(python='2.7')
+@nox.session(python='3.6')
 def docs(session):
     '''
     Build Salt's Documentation
     '''
-    session.install('--progress-bar=off', '-r', 'requirements/static/py2.7/docs.txt', silent=PIP_INSTALL_SILENT)
+    session.install('--progress-bar=off', '-r', 'requirements/static/py3.6/docs.txt', silent=PIP_INSTALL_SILENT)
     os.chdir('doc/')
     session.run('make', 'clean', external=True)
     session.run('make', 'html', external=True)

requirements/static/docs.in

@@ -1 +1 @@
-sphinx
+sphinx>=2.0.1

requirements/static/py3.6/docs.txt

@@ -2,10 +2,10 @@
 # This file is autogenerated by pip-compile
 # To update, run:
 #
-#    pip-compile -o requirements/static/py2.7/docs.txt -v requirements/static/docs.in
+#    pip-compile -o requirements/static/py3.6/docs.txt -v requirements/static/docs.in
 #
 alabaster==0.7.12         # via sphinx
-babel==2.6.0              # via sphinx
+babel==2.7.0              # via sphinx
 certifi==2019.3.9         # via requests
 chardet==3.0.4            # via requests
 docutils==0.14            # via sphinx
@@ -14,13 +14,17 @@ imagesize==1.1.0          # via sphinx
 jinja2==2.10.1            # via sphinx
 markupsafe==1.1.1         # via jinja2
 packaging==19.0           # via sphinx
-pygments==2.3.1           # via sphinx
+pygments==2.4.2           # via sphinx
 pyparsing==2.4.0          # via packaging
 pytz==2019.1              # via babel
-requests==2.21.0          # via sphinx
+requests==2.22.0          # via sphinx
-six==1.12.0               # via packaging, sphinx
+six==1.12.0               # via packaging
 snowballstemmer==1.2.1    # via sphinx
-sphinx==1.8.5
+sphinx==2.0.1
-sphinxcontrib-websupport==1.1.0  # via sphinx
+sphinxcontrib-applehelp==1.0.1  # via sphinx
-typing==3.6.6             # via sphinx
+sphinxcontrib-devhelp==1.0.1  # via sphinx
-urllib3==1.24.2           # via requests
+sphinxcontrib-htmlhelp==1.0.2  # via sphinx
+sphinxcontrib-jsmath==1.0.1  # via sphinx
+sphinxcontrib-qthelp==1.0.2  # via sphinx
+sphinxcontrib-serializinghtml==1.1.3  # via sphinx
+urllib3==1.25.3           # via requests