From: Andrew Grimberg <agrimberg@linuxfoundation.org>
Date: Mon, 24 Jul 2023 15:17:23 +0000 (-0700)
Subject: Docs: Add RTD config file
X-Git-Tag: v0.88.3~2
X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=commitdiff_plain;h=04672921bb62e3fa8975425ff392f839c799437b;p=releng%2Fglobal-jjb.git

Docs: Add RTD config file

RTD will start requiring configuration files on September 25, 2023.
This also makes sure that we properly unshallow the clone as that is a
feature flag that is going away as well.

Issue: RELENG-4816
Change-Id: Ia3015cd6f519158ac03ddcb3453d3ac4fb233d51
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
---

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 00000000..9cd1c3aa
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,28 @@
+---
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Optionally build your docs in additional formats such as PDF
+formats:
+  - pdf
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  jobs:
+    post_checkout:
+      - git fetch --unshallow || true
+
+python:
+  install:
+    - requirements: requirements.txt
+    - path: .
+      method: pip