[WIP] [Docs] Docs deps upgrade

.readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.11"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

doc/Makefile

@@ -2,7 +2,7 @@
 #
 
 # You can set these variables from the command line.
-SPHINXOPTS    = -a -E
+SPHINXOPTS    = -a -E -W -j auto
 SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build

doc/requirements-doc.txt

@@ -1,35 +1,33 @@
 # Production requirements. This is what readthedocs.com picks up
 
-ray
-watchfiles # Required because sphinx-click doesn't support mocking
+git+https://github.com/ray-project/tune-sklearn@master#tune-sklearn
+watchfiles==0.20.0 # Required because sphinx-click doesn't support mocking
 
 # Syntax highlighting
-Pygments==2.13.0
+Pygments==2.16.1
 
 # Sphinx
-sphinx==4.3.2
-sphinx-click==3.0.2
-sphinx-copybutton==0.4.0
+sphinx==7.2.6
+sphinx-click==5.0.1
+sphinx-copybutton==0.5.2
 sphinxemoji==0.2.0
-sphinx-jsonschema==1.17.2
+sphinx-jsonschema==1.19.1
 sphinx-version-warning==1.1.2
-sphinx-book-theme==0.3.3
-sphinx-external-toc==0.2.4
-sphinx-sitemap==2.2.0
+sphinx-sitemap==2.5.1
 sphinxcontrib-redoc==1.6.0
-sphinx-tabs==3.4.0
 sphinx-remove-toctrees==0.0.3
-autodoc_pydantic==1.6.1
-sphinx_design==0.4.1
+autodoc_pydantic==1.9.0
+sphinx_design==0.5.0
+pydata-sphinx-theme==0.14.1
 
-pydantic<2 # Pydantic is required by autodoc_pydantic, but must be <2 for ray
+pydantic<2
 
 # MyST
-myst-parser==0.15.2
-myst-nb==0.13.1
+myst-parser==2.0.0 # Needed to parse markdown
+myst-nb==1.0.0rc0 # Most recent version of myst-nb; pin when new release is made
 
 # Jupyter conversion
-jupytext==1.13.6
+jupytext==1.15.2
 
 # Pin urllib to avoid downstream ssl incompatibility issues
 urllib3 < 1.27

doc/source/_static/css/assistant.css

@@ -0,0 +1,136 @@
+/* Kapa Ask AI button */
+#kapa-widget-container figure {
+    padding: 0 !important;
+  }
+
+  .mantine-Modal-root figure {
+    padding: 0 !important;
+  }
+
+.container-xl.blurred {
+    filter: blur(5px);
+}
+
+.chat-widget {
+    position: fixed;
+    bottom: 10px;
+    right: 10px;
+    z-index: 1000;
+}
+
+.chat-popup {
+  display: none;
+  position: fixed;
+  top: 20%;
+  left: 50%;
+  transform: translate(-50%, -20%);
+  width: 50%;
+  height: 70%;
+  background-color: var(--pst-color-surface);
+  border: 1px solid var(--pst-color-border);
+  border-radius: 10px;
+  box-shadow: 0 5px 10px var(--pst-color-shadow);
+  z-index: 1032;
+  max-height: 1000px;
+  overflow: hidden;
+  padding-bottom: 40px;
+}
+
+.chatFooter {
+    position: absolute;
+    bottom: 0;
+    right: 0;
+    width: 100%;
+    background-color: var(--pst-color-surface);
+}
+
+#openChatBtn {
+    background-color: var(--pst-color-on-background);
+    color: var(--pst-color-text-base);
+    width: 70px;
+    height: 70px;
+    border-radius: 10px;
+    border: none;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+}
+
+#closeChatBtn {
+    border: none;
+    background-color: transparent;
+    color: var(--pst-color-text-base);
+    font-size: 1.2em;
+}
+
+#closeChatBtn:hover {
+    color: var(--pst-color-link-hover);
+}
+
+#searchBar {
+  border: 1px solid var(--pst-color-border);
+  background-color: var(--pst-color-on-surface);
+}
+
+.chatHeader {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: .5rem;
+}
+
+.chatHeader > .header-wrapper {
+  text-align: center;
+  width: 100%;
+}
+
+.chatContentContainer {
+    padding: 15px;
+    max-height: calc(100% - 80px);
+    overflow-y: auto;
+}
+
+.chatContentContainer input {
+    margin-top: 10px;
+    margin-bottom: 10px;
+}
+
+#result{
+  padding: 15px;
+  border-radius: 10px;
+  margin-top: 10px;
+  margin-bottom: 10px;
+  background-color: var(--pst-color-on-surface);
+  max-height: calc(100% - 20px);
+  overflow-y: auto;
+}
+
+.chatContentContainer textarea {
+  flex-grow: 1;
+  min-width: 50px;
+  max-height: 40px;
+  resize: none;
+}
+
+.searchBtn {
+    white-space: nowrap;
+}
+
+.input-group {
+    display: flex;
+    align-items: stretch;
+}
+
+#blurDiv {
+  width: 100vw;
+  height: 100vh;
+  position: fixed;
+  top: 0;
+  left: 0;
+  backdrop-filter: blur(5px);
+  z-index: 1031;
+}
+
+#blurDiv.blurDiv-hidden {
+  display: none !important;
+}

doc/source/_static/css/csat.css

@@ -0,0 +1,77 @@
+/* CSAT widgets */
+#csat-inputs {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+}
+
+.csat-hidden {
+  display: none !important;
+}
+
+#csat-feedback-label {
+  color: var(--pst-color-text-base);
+  font-weight: 500;
+}
+
+.csat-button {
+  margin-left: 16px;
+  padding: 8px 16px 8px 16px;
+  border-radius: 4px;
+  border: 1px solid var(--pst-color-border);
+  background: var(--pst-color-background);
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  width: 85px;
+}
+
+#csat-textarea-group {
+  display: flex;
+  flex-direction: column;
+}
+
+#csat-submit {
+  margin-left: auto;
+  font-weight: 700;
+  border: none;
+  margin-top: 12px;
+  cursor: pointer;
+}
+
+#csat-feedback-received {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  justify-content: center;
+}
+
+.csat-button-active {
+  border: 1px solid var(--pst-color-border);
+}
+
+.csat-icon {
+  margin-right: 4px;
+}
+
+#csat {
+  padding: 1em;
+  min-width: 60%;
+}
+
+#csat-textarea {
+  resize: none;
+  background-color: var(--pst-color-on-background);
+  border: 1px solid var(--pst-color-border);
+  border-radius: 4px;
+}
+
+#csat-textarea::placeholder {
+  color: var(--pst-color-text-base);
+}
+
+.csat-icon > path {
+  fill: var(--pst-color-text-base);
+}