DRIVERS-2789 Trim RST files to Stubs (#1566)

* DRIVERS-2789 Trim RST files to Stubs

* remove sphinx build check

Author: blink1073

.github/workflows/lint.yml

@@ -27,13 +27,3 @@ jobs:
           echo "    pre-commit run"
           echo "or after-the-fact on already committed files with"
           echo "    pre-commit run --all-files --hook-stage manual"
-
-  sphinx-build:
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v4
-      - run:  pip install sphinx
-      - run:  cd source && sphinx-build -W -b text . docs_build index.rst

scripts/migrate_to_md.py

@@ -28,18 +28,13 @@
 .. note::
   This specification has been converted to Markdown and renamed to
   `{0} <{0}>`_.  
-
-  Use the link above to access the latest version of the specification as the
-  current reStructuredText file will no longer be updated.
-
 """
 
-# Update the RST file with a pointer to the MD file.
+# Update the RST file with a stub pointer to the MD file.
 if not path.name == 'README.rst':
-    new_lines = lines.copy()
-    new_lines.insert(0, TEMPLATE.format(os.path.basename(md_file)) )
+    new_body = TEMPLATE.format(os.path.basename(md_file))
     with path.open('w') as fid:
-        fid.write(''.join(new_lines))
+        fid.write(''.join(new_body))
 
 # Pre-process the file.
 for (i, line) in enumerate(lines):