From 6e13b5b0f3da989e139493aadcd519c4ebbdc896 Mon Sep 17 00:00:00 2001 From: Sydney Duckworth Date: Thu, 5 Nov 2026 09:54:19 -0500 Subject: [PATCH 1/2] Updated link for compatibility with upcoming asdf docs changes --- docs/conf.py | 4 ++++ docs/usage/overview.rst | 5 ++--- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 741bd610..5111ed5a 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -143,8 +143,12 @@ def read_config_h() -> tuple[str, str, str]: 'numpy': ('https://numpy.org/doc/stable/', None) } + +extlinks = {'asdf': ('https://www.asdf-format.org/projects/asdf/en/stable/%s', None)} + extensions = [ 'sphinx.ext.intersphinx', + 'sphinx.ext.extlinks', 'sphinx.ext.todo', 'hawkmoth', # Local; see docs/_ext/ diff --git a/docs/usage/overview.rst b/docs/usage/overview.rst index f0f318ba..c9b71bb5 100644 --- a/docs/usage/overview.rst +++ b/docs/usage/overview.rst @@ -78,9 +78,8 @@ ndarrays (N-dimension typed arrays) One of the most important and widely used types in ASDF is the **ndarray**. The concept originates from `NumPy`_, the Python library for efficient -numerical computing with *n*-dimensional arrays. In the -:external:doc:`Python ASDF implementation `, NumPy arrays are -serialized under the tag +numerical computing with *n*-dimensional arrays. In the :asdf:`Python ASDF implementation `, +NumPy arrays are serialized under the tag :ref:`core/ndarray `. Although the tag name and conventions come from Python, the underlying idea is language-independent: an ``ndarray`` represents a typed, multi-dimensional From 61bc3522f7407c3e0896955f44fb2608dbdd75da Mon Sep 17 00:00:00 2001 From: Sydney Duckworth Date: Thu, 5 Nov 2026 10:21:42 -0500 Subject: [PATCH 2/2] Removed `asdf` from `intersphinx` mapping --- docs/conf.py | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 5111ed5a..ea0bd03a 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -138,7 +138,6 @@ def read_config_h() -> tuple[str, str, str]: # Add intersphinx mappings # e.g. intersphinx_mapping["semantic_version"] = ("https://python-semanticversion.readthedocs.io/en/latest/", None) intersphinx_mapping = { - 'asdf': ('https://www.asdf-format.org/projects/asdf/en/stable', None), 'asdf-standard': ('https://www.asdf-format.org/projects/asdf-standard/en/latest/', None), 'numpy': ('https://numpy.org/doc/stable/', None) }