Merge branch 'main' into allow-dates-with-no-times

Author: rly

.readthedocs.yaml

@@ -0,0 +1,22 @@
+# 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.12"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: source/conf.py
+
+# Optionally build your docs in additional formats such as PDF and ePub
+formats: all
+
+# Optionally set the version of Python and requirements required to build your docs
+python:
+  install:
+    - requirements: requirements-doc.txt

Readme.md

@@ -2,7 +2,7 @@
 
 The NWB specification language defines formal structures for describing the organization of complex data using basic
 concepts, e.g., Groups, Datasets, Attributes, and Links. See the
-[documentation](http://nwb-schema-language.readthedocs.io/) for more information and release notes.
+[documentation](https://schema-language.readthedocs.io/en/latest/) for more information and release notes.
 
 The NWB specification language is used by the [Neurodata Without Borders (NWB)](https://www.nwb.org) neurophysiology
 data standard and is based off of the [Hierarchical Data Modeling Framework (HDMF)](https://github.com/hdmf-dev/hdmf)

requirements-doc.txt

@@ -1 +1,3 @@
 ruamel.yaml
+sphinx
+sphinx_rtd_theme

source/conf.py

@@ -107,7 +107,8 @@
 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 with open('namespace_map.yml', 'r') as f:
-    namespace_map = yaml.safe_load(f)
+    yaml = yaml.YAML(typ='safe', pure=True)
+    namespace_map = yaml.load(f)
 
 
 def rstjinja(app, docname, source):