Doc extensions: use StringList instead of ViewList

docs/ext/operations_user_doc.py

@@ -6,7 +6,7 @@
 
 from docutils import nodes
 from docutils.nodes import Node
-from docutils.statemachine import ViewList
+from docutils.statemachine import StringList
 from docutils.parsers.rst import Directive
 from sphinx.util.nodes import nested_parse_with_titles
 """Custom extension to add nicely formatted documentation for the operations.
@@ -81,7 +81,7 @@ def run(self) -> list[Node]:
             rst_lines.append(f":class:`{op.filter_name} API docs<mantidimaging.core.operations.{op.__module__}>`")
             rst_lines.append("")
 
-        rst = ViewList()
+        rst = StringList()
         for n, rst_line in enumerate(rst_lines):
             rst.append(rst_line, "generated.rst", n)
 

docs/ext/release_notes.py

@@ -6,7 +6,7 @@
 from typing import Iterable
 
 from docutils import nodes
-from docutils.statemachine import ViewList
+from docutils.statemachine import StringList
 from docutils.parsers.rst import Directive
 from sphinx.errors import SphinxError
 from sphinx.util.nodes import nested_parse_with_titles
@@ -24,10 +24,10 @@ class ReleaseNotes(Directive):
     has_content = True
 
     @classmethod
-    def make_rst(cls, note_type: str) -> ViewList:
+    def make_rst(cls, note_type: str) -> StringList:
         note_paths: Iterable[Path] = (Path() / 'docs' / 'release_notes' / 'next').glob(note_type + '*')
 
-        rst = ViewList()
+        rst = StringList()
         try:
             note_paths = sorted(note_paths, key=lambda p: int(p.name.split('-')[1]))
         except ValueError as exc:

docs/release_notes/2.7.rst

@@ -1,3 +1,6 @@
+Mantid Imaging 2.7
+==================
+
 New Features
 ------------
 - #1912 : Support sub-directories in Live viewer

docs/release_notes/next/dev-2139-use-stringlist

@@ -0,0 +1 @@
+#2139 : Doc extensions: use StringList instead of ViewList

environment-dev.yml

@@ -19,7 +19,7 @@ dependencies:
   - mypy==1.8
   - types-requests
   - types-PyYAML
-  - types-docutils==0.20.0.20240311 # https://github.com/mantidproject/mantidimaging/issues/2139
+  - types-docutils
   - pytest==7.4.*
   - pytest-cov==4.1.*
   - pytest-randomly==3.15.*