From efc545a13b37578d55630727b376b4d093c5d7b5 Mon Sep 17 00:00:00 2001
From: Wilfred Tyler Gee <wtylergee@gmail.com>
Date: Wed, 29 Nov 2023 08:30:37 -1000
Subject: [PATCH] * Adding readthedocs configs * Theme change to pydata * Index
 page change.

---
 .readthedocs.yaml     | 32 ++++++++++++++++++++++++++++++++
 README.md             |  2 +-
 docs/conf.py          |  4 ++--
 docs/index.md         | 29 ++++++++---------------------
 docs/requirements.txt |  4 +++-
 setup.cfg             |  1 -
 6 files changed, 46 insertions(+), 26 deletions(-)
 create mode 100644 .readthedocs.yaml

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..019ba61
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,32 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+    # You can also specify other tool versions:
+    # nodejs: "19"
+    # rust: "1.64"
+    # golang: "1.19"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#    - pdf
+#    - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: docs/requirements.txt
diff --git a/README.md b/README.md
index a0d598b..3f65027 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # PANOPTES Data tools
 
-Tools for working with PANOPTES data.
+Tools for searching and downloading PANOPTES data.
 
 ## Install
 
diff --git a/docs/conf.py b/docs/conf.py
index 6dc178c..1bce9c1 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -171,7 +171,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = "alabaster"
+html_theme = "pydata_sphinx_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -301,4 +301,4 @@
     "pyscaffold": ("https://pyscaffold.org/en/stable", None),
 }
 
-print(f"loading configurations for {project} {version} ...", file=sys.stderr)
\ No newline at end of file
+print(f"loading configurations for {project} {version} ...", file=sys.stderr)
diff --git a/docs/index.md b/docs/index.md
index cdb6461..d8328f5 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,29 +1,13 @@
-# panoptes-data
-
-Tools for working with PANOPTES data.
-
-
-## Note
-
-> This is the main page of your project's [Sphinx] documentation. It is
-> formatted in [Markdown]. Add additional pages by creating md-files in
-> `docs` or rst-files (formatted in [reStructuredText]) and adding links to
-> them in the `Contents` section below.
->
-> Please check [Sphinx] and [MyST] for more information
-> about how to document your project and how to configure your preferences.
-
+```{include} ../README.md
+:relative-docs: docs/
+:relative-images:
+```
 
-## Contents
+## API reference
 
 ```{toctree}
 :maxdepth: 2
 
-Overview <readme>
-Contributions & Help <contributing>
-License <license>
-Authors <authors>
-Changelog <changelog>
 Module Reference <api/modules>
 ```
 
@@ -34,6 +18,9 @@ Module Reference <api/modules>
 * {ref}`search`
 
 [Sphinx]: http://www.sphinx-doc.org/
+
 [Markdown]: https://daringfireball.net/projects/markdown/
+
 [reStructuredText]: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
+
 [MyST]: https://myst-parser.readthedocs.io/en/latest/
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 2ddf98a..5d3210c 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,7 @@
 # Requirements file for ReadTheDocs, check .readthedocs.yml.
 # To build the module reference correctly, make sure every external package
 # under `install_requires` in `setup.cfg` is also listed here!
+linkify-it-py
+myst-parser
+pydata-sphinx-theme
 sphinx>=3.2.1
-# sphinx_rtd_theme
diff --git a/setup.cfg b/setup.cfg
index 65fc0a3..871b3c6 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -57,7 +57,6 @@ install_requires =
     tqdm
     typer
 
-
 [options.packages.find]
 where = src
 exclude =