Add docs on spec language support (#1069)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

CHANGELOG.md

@@ -1,5 +1,10 @@
 # HDMF Changelog
 
+## HDMF 3.13.0 (Upcoming)
+
+### Enhancements
+- Added docs page that lists limitations of support for the HDMF specification language. @rly [#1069](https://github.com/hdmf-dev/hdmf/pull/1069)
+
 ## HDMF 3.12.2 (February 9, 2024)
 
 ### Bug fixes

docs/source/index.rst

@@ -45,6 +45,7 @@ If you use HDMF in your research, please use the following citation:
    building_api
    export
    validation
+   spec_language_support
 
 .. toctree::
    :hidden:

docs/source/spec_language_support.rst

@@ -0,0 +1,21 @@
+
+..  _spec_language_support:
+
+===========================================
+Support for the HDMF Specification Language
+===========================================
+
+The HDMF API provides nearly full support for all features of the `HDMF Specification Language`_
+version 3.0.0, except for the following:
+
+1. Attributes containing multiple references (see `#833`_)
+2. Certain text and integer values for quantity (see `#423`_, `#531`_)
+3. Datasets that do not have a data_type_inc/data_type_def and contain either a reference dtype or a compound dtype (see `#737`_)
+4. Passing dataset dtype and shape from parent data type to child data type (see `#320`_)
+
+.. _HDMF Specification Language: https://hdmf-schema-language.readthedocs.io
+.. _#833: https://github.com/hdmf-dev/hdmf/issues/833
+.. _#423: https://github.com/hdmf-dev/hdmf/issues/423
+.. _#531: https://github.com/hdmf-dev/hdmf/issues/531
+.. _#737: https://github.com/hdmf-dev/hdmf/issues/737
+.. _#320: https://github.com/hdmf-dev/hdmf/issues/320