From 061c1edb49b188688b54b22873ac1fa7b65e433e Mon Sep 17 00:00:00 2001
From: Carsen Stringer <carsen.stringer@gmail.com>
Date: Thu, 29 Feb 2024 07:59:23 -0500
Subject: [PATCH] adding rtd and badges

---
 .readthedocs.yml      | 31 +++++++++++++++++++++++++++++++
 README.md             | 15 ++++++++++++++-
 docs/requirements.txt |  5 +++++
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 .readthedocs.yml
 create mode 100644 docs/requirements.txt

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 00000000..a7ad6f80
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,31 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+    
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Build documentation with MkDocs
+#mkdocs:
+#  configuration: mkdocs.yml
+
+# Optionally build your docs in additional formats such as PDF
+formats:
+  - pdf
+
+# specify dependencies
+python:
+   install:
+      - requirements: docs/requirements.txt
+      - method: pip
+        path: .
+        extra_requirements:
+          - docs
diff --git a/README.md b/README.md
index c76a2b47..dc689b7c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,17 @@
-# Kilosort4 pre-release
+# Kilosort4
+
+[![Documentation Status](https://readthedocs.org/projects/kilosort/badge/?version=latest)](https://kilosort.readthedocs.io/en/latest/?badge=latest)
+![tests](https://github.com/mouseland/kilosort/actions/workflows/test_and_deploy.yml/badge.svg)
+[![PyPI version](https://badge.fury.io/py/kilosort.svg)](https://badge.fury.io/py/kilosort)
+[![Downloads](https://pepy.tech/badge/kilosort)](https://pepy.tech/project/kilosort)
+[![Downloads](https://pepy.tech/badge/kilosort/month)](https://pepy.tech/project/kilosort)
+[![Python version](https://img.shields.io/pypi/pyversions/kilosort)](https://pypistats.org/packages/kilosort)
+[![Licence: GPL v3](https://img.shields.io/github/license/MouseLand/kilosort)](https://github.com/MouseLand/kilosort/blob/master/LICENSE)
+[![Contributors](https://img.shields.io/github/contributors-anon/MouseLand/kilosort)](https://github.com/MouseLand/kilosort/graphs/contributors)
+[![repo size](https://img.shields.io/github/repo-size/MouseLand/kilosort)](https://github.com/MouseLand/kilosort/)
+[![GitHub stars](https://img.shields.io/github/stars/MouseLand/kilosort?style=social)](https://github.com/MouseLand/kilosort/)
+[![GitHub forks](https://img.shields.io/github/forks/MouseLand/kilosort?style=social)](https://github.com/MouseLand/kilosort/)
+
 
 You can run Kilosort4 without installing it locally using google colab. An example colab notebook is available [here](https://colab.research.google.com/drive/1gFZa8TEBDXmg_CB5RwuT_52Apl3hP0Ie?usp=sharing). It will download some test data, run kilosort4 on it, and show some plots.
 
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 00000000..2889ac7f
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,5 @@
+ipykernel
+nbsphinx
+sphinx==5.3.0
+sphinx_rtd_theme==1.1.1
+readthedocs-sphinx-search==0.3.2