DOC: Fix headers (#12781)

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: larsoner

.github/actions/rename_towncrier/rename_towncrier.py

@@ -1,5 +1,9 @@
 #!/usr/bin/env python3
 
+# Authors: The MNE-Python contributors.
+# License: BSD-3-Clause
+# Copyright the MNE-Python contributors.
+
 # Adapted from action-towncrier-changelog
 import json
 import os

.github/workflows/autofix.yml

@@ -9,13 +9,14 @@ permissions:
 
 jobs:
   autofix:
-    name: Autoupdate changelog entry
+    name: Autoupdate changelog entry and headers
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-      - run: pip install --upgrade towncrier pygithub
+      - run: pip install --upgrade towncrier pygithub gitpython numpy
       - run: python ./.github/actions/rename_towncrier/rename_towncrier.py
+      - run: python ./tools/dev/ensure_headers.py
       - uses: autofix-ci/action@dd55f44df8f7cdb7a6bf74c78677eb8acd40cd0a

.github/workflows/credit.yml

@@ -25,7 +25,6 @@ jobs:
       - run: pip install pygithub -e .
       - run: git checkout -b credit
       - run: python tools/dev/update_credit_json.py
-      - run: python tools/dev/update_credit_rst.py
       - run: git add -f doc/sphinxext/prs/*.json
       - run: |
           git diff && git status --porcelain

azure-pipelines.yml

@@ -244,7 +244,7 @@ stages:
           PYTHONIOENCODING: 'utf-8'
           AZURE_CI_WINDOWS: 'true'
           PYTHON_ARCH: 'x64'
-        timeoutInMinutes: 70
+        timeoutInMinutes: 75
         strategy:
           maxParallel: 4
           matrix:

doc/changes/devel/12781.other.rst

@@ -1,8 +1,11 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
+"""Configuration file for the Sphinx documentation builder.
+
+This file only contains a selection of the most common options. For a full
+list see the documentation:
+https://www.sphinx-doc.org/en/master/usage/configuration.html
+"""
+
+# Authors: The MNE-Python contributors.
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
 

doc/conf.py

@@ -1,3 +1,5 @@
+# Authors: The MNE-Python contributors.
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
+
 from mne.conftest import *  # noqa

doc/conftest.py

@@ -1,5 +1,7 @@
+# Authors: The MNE-Python contributors.
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
+
 import os
 from pathlib import Path
 

doc/sphinxext/contrib_avatars.py

@@ -1,5 +1,7 @@
+# Authors: The MNE-Python contributors.
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
+
 import os
 from os import path as op
 

doc/sphinxext/flow_diagram.py

@@ -1,5 +1,7 @@
+# Authors: The MNE-Python contributors.
 # License: BSD-3-Clause
 # Copyright the MNE-Python contributors.
+
 import glob
 from importlib import import_module
 from pathlib import Path