From 67d1a1556a2f1b694681989b5e4bb41c5611c338 Mon Sep 17 00:00:00 2001 From: Aniket Singh Yadav Date: Wed, 29 Apr 2026 07:17:35 +0000 Subject: [PATCH 1/3] add guidance on taking over a stale pull request --- doc/development/contributing.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/doc/development/contributing.rst b/doc/development/contributing.rst index beed58f6558..68c68de3aba 100644 --- a/doc/development/contributing.rst +++ b/doc/development/contributing.rst @@ -658,6 +658,34 @@ change, and append additional PR numbers in parentheticals with the ``:gh:`` rol Short description of the changes, by `Firstname Lastname`_. (:gh:`12346`) + +.. _taking-over-a-stale-pr: + +Taking over a stale pull request +--------------------------------- + +If a pull request has been abandoned, you can take it over. Always credit +the original author by adding a ``Co-authored-by`` trailer to your commit +message:: + + Co-authored-by: Original Author Name + +To build on top of their existing branch: + +.. code-block:: bash + + git remote add original-author https://github.com//mne-python.git + git fetch original-author + git checkout -b takeover-XXXXX original-author/ + +Then push to your fork and open a new PR referencing the original +(e.g., "Takes over :gh:`XXXXX`"). Make sure their name is in +``doc/changes/names.inc`` and credit them in the changelog entry, e.g.: + +.. code-block:: rst + + Short description, by `Your Name`_ and `Original Author`_. (:gh:`XXXXX`) + Test locally before opening pull requests (PRs) ----------------------------------------------- From 327e4a86a2bcdbe2816a6a1c574a4e24baf0188a Mon Sep 17 00:00:00 2001 From: Aniket <148300120+Aniketsy@users.noreply.github.com> Date: Thu, 30 Apr 2026 00:39:08 +0530 Subject: [PATCH 2/3] Update doc/development/contributing.rst Co-authored-by: Thomas S. Binns --- doc/development/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/development/contributing.rst b/doc/development/contributing.rst index 68c68de3aba..717520bb1e3 100644 --- a/doc/development/contributing.rst +++ b/doc/development/contributing.rst @@ -684,7 +684,7 @@ Then push to your fork and open a new PR referencing the original .. code-block:: rst - Short description, by `Your Name`_ and `Original Author`_. (:gh:`XXXXX`) + Short description of the changes, by `Your Name`_ and `Original Author`_. Test locally before opening pull requests (PRs) ----------------------------------------------- From f7073df253b1f749ec78bf009f808be2b5f8d08d Mon Sep 17 00:00:00 2001 From: Aniket <148300120+Aniketsy@users.noreply.github.com> Date: Thu, 30 Apr 2026 00:39:26 +0530 Subject: [PATCH 3/3] Update doc/development/contributing.rst Co-authored-by: Thomas S. Binns --- doc/development/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/development/contributing.rst b/doc/development/contributing.rst index 717520bb1e3..68abf8b71a7 100644 --- a/doc/development/contributing.rst +++ b/doc/development/contributing.rst @@ -680,7 +680,7 @@ To build on top of their existing branch: Then push to your fork and open a new PR referencing the original (e.g., "Takes over :gh:`XXXXX`"). Make sure their name is in -``doc/changes/names.inc`` and credit them in the changelog entry, e.g.: +``doc/changes/names.inc`` and credit the original author in the changelog entry, e.g.: .. code-block:: rst