feature: add adobe analytics script; upgrade sphinx to support custom js

Author: aaronmarkham

doc/conf.py

@@ -13,7 +13,6 @@
 """Placeholder docstring"""
 from __future__ import absolute_import
 
-import os
 import pkg_resources
 import sys
 from datetime import datetime
@@ -83,13 +82,13 @@ def __getattr__(cls, name):
 autodoc_default_flags = ["show-inheritance", "members", "undoc-members"]
 autodoc_member_order = "bysource"
 
-if "READTHEDOCS" in os.environ:
-    html_theme = "default"
-else:
-    html_theme = "haiku"
-html_static_path = []
+html_theme = "sphinx_rtd_theme"
+
+html_static_path = ["_static"]
 htmlhelp_basename = "%sdoc" % project
 
+html_js_files = ["https://a0.awsstatic.com/s_code/js/1.0/awshome_s_code.js", "js/analytics.js"]
+
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {"http://docs.python.org/": None}
 

doc/doc_environment.yml

@@ -0,0 +1,23 @@
+name: sagemaker-docs
+channels:
+- conda-forge
+dependencies:
+- conda>=4.6.13
+- jupyter
+- matplotlib
+- notebook
+- pip
+- python==3.7
+- tox
+- pip:
+  - awscli
+  - breathe
+  - mock
+  - nbconvert
+  - nbsphinx>=0.4.2
+  - notedown
+  - pypandoc
+  - recommonmark
+  - sagemaker
+  - sphinx==2.2.2
+  - sphinx-rtd-theme

doc/requirements.txt

@@ -1,4 +1,4 @@
-sphinx==1.7.9
+sphinx==2.2.2
 numpy
 scipy
-requests==2.20
+requests==2.20

tox.ini

@@ -4,7 +4,7 @@
 # and then run "tox" from this directory.
 
 [tox]
-envlist = black-format,flake8,pylint,twine,sphinx,py27,py36
+envlist = black-format,flake8,pylint,twine,sphinx,py27,py36,py37
 
 skip_missing_interpreters = False
 
@@ -104,7 +104,7 @@ deps =
     alabaster>=0.7,<0.8,!=0.7.5
     commonmark==0.5.4
     recommonmark==0.4.0
-    sphinx<1.8
+    sphinx==2.2.2
     sphinx-rtd-theme<0.5
     readthedocs-sphinx-ext<0.6
 # pip install requirements.txt is separate as RTD does it in separate steps