Add Read the Docs configuration and update documentation requirements

Author: alessandratrapani

.readthedocs.yml

@@ -0,0 +1,27 @@
+# .readthedocs.yml
+# 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
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/source/conf.py
+
+# Optionally build your docs in additional formats such as PDF
+formats:
+  - pdf
+
+# Optionally set the version of Python and requirements required to build your docs
+python:
+  install:
+    - method: pip
+      path: .
+    - requirements: docs/requirements.txt

docs/requirements.txt

@@ -0,0 +1,3 @@
+sphinx>=5.0.0
+sphinx_rtd_theme>=1.0.0
+hdmf-docutils>=0.4.1

pyproject.toml

@@ -14,13 +14,7 @@ readme = "README.md"
 # requires-python = ">=3.8"
 license = {text = "BSD-3"}
 classifiers = [
-    # TODO: add classifiers before release
-    # "Programming Language :: Python",
-    # "Programming Language :: Python :: 3.8",
-    # "Programming Language :: Python :: 3.9",
-    # "Programming Language :: Python :: 3.10",
-    # "Programming Language :: Python :: 3.11",
-    # "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.11",
     # "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
@@ -38,13 +32,12 @@ dependencies = [
     "ndx-ophys-devices>=0.1.1"
 ]
 
-# TODO: add URLs before release
-# [project.urls]
-# "Homepage" = "https://github.com/organization/package"
-# "Documentation" = "https://package.readthedocs.io/"
-# "Bug Tracker" = "https://github.com/organization/package/issues"
-# "Discussions" = "https://github.com/organization/package/discussions"
-# "Changelog" = "https://github.com/organization/package/blob/main/CHANGELOG.md"
+[project.urls]
+"Homepage" = "https://github.com/CatalystNeuro/ndx-microscopy"
+"Documentation" = "https://ndx-microscopy.readthedocs.io/"
+"Bug Tracker" = "https://github.com/CatalystNeuro/ndx-microscopy/issues"
+"Discussions" = "https://github.com/CatalystNeuro/ndx-microscopy/discussions"
+"Changelog" = "https://github.com/CatalystNeuro/ndx-microscopy/blob/main/CHANGELOG.md"
 
 # Include only the source code under `src/pynwb/ndx_microscopy` and the spec files under `spec`
 # in the wheel.