[MAINT]: Fold notebook header removal logic to nbstripout

.pre-commit-config.yaml

@@ -1,23 +1,25 @@
 repos:
   - repo: https://github.com/kynan/nbstripout
-    rev: 0.8.1
+    rev: 34071b78c181af3bf5af955c1426466e096fc3db #0.9.1
     hooks:
       - id: nbstripout
-        args:
-          - '--keep-output'
+        args: [--keep-output, '--extra-keys=metadata.kernelspec']
+        files: ^doc/*\.(ipynb)$
 
   - repo: local
     hooks:
-    - id: remove-notebook-headers
-      name: Remove Notebook Headers
-      entry: python ./build_scripts/remove_notebook_headers.py
-      language: python
-      files: ^doc.*\.(ipynb)$
-    - id: sanitize-notebook-paths
-      name: Sanitize Notebook Paths
-      entry: python ./build_scripts/sanitize_notebook_paths.py
-      language: python
-      files: ^doc.*\.(ipynb)$
+      - id: sanitize-notebook-paths
+        name: Sanitize Notebook Paths
+        entry: python ./build_scripts/sanitize_notebook_paths.py
+        language: python
+        files: ^doc.*\.(ipynb)$
+      - id: validate-docs
+        name: Validate Documentation Structure
+        entry: python ./build_scripts/validate_docs.py
+        language: python
+        files: ^(doc/.*\.(py|ipynb|md)|doc/myst\.yml)$
+        pass_filenames: false
+        additional_dependencies: ['pyyaml']
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
@@ -66,23 +68,3 @@ repos:
         entry: mypy
         language: system
         types: [ python ]
-
-  - repo: local
-    hooks:
-      - id: remove-notebook-headers
-        name: Remove Notebook Headers
-        entry: python ./build_scripts/remove_notebook_headers.py
-        language: python
-        files: ^doc.*\.(ipynb)$
-      - id: sanitize-notebook-paths
-        name: Sanitize Notebook Paths
-        entry: python ./build_scripts/sanitize_notebook_paths.py
-        language: python
-        files: ^doc.*\.(ipynb)$
-      - id: validate-docs
-        name: Validate Documentation Structure
-        entry: python ./build_scripts/validate_docs.py
-        language: python
-        files: ^(doc/.*\.(py|ipynb|md)|doc/myst\.yml)$
-        pass_filenames: false
-        additional_dependencies: ['pyyaml']