From 4dbd31b7f2f2b643a7dda1d7c47d72dd3c086fcd Mon Sep 17 00:00:00 2001 From: Julia Sprenger Date: Mon, 9 Nov 2026 10:20:23 +0100 Subject: [PATCH 1/4] Add AI notes to contribution guide --- doc/source/contributing.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst index c5f081afb..efd0308cd 100644 --- a/doc/source/contributing.rst +++ b/doc/source/contributing.rst @@ -12,16 +12,15 @@ If you're new to open source software, `How to Contribute to Open Source`_ is a Discussing with other Neo developers ==================================== -If you have an idea for improving Neo, the first step is to discuss it with other Neo developers -on the NeuralEnsemble `mailing list`_. +If you have an idea for improving Neo, want to discuss a specific problem or report a bug, the first step is to +open an issue in the `issue tracker`_. Provide details on what you would like to change, why this change would be usefull and describe a use case if possible. -Discussion of issues specific to a particular ticket in the `issue tracker`_ -should take place on the tracker. +Usage of AI +=========== -.. note:: Note that the mailing list is shared with other projects in the general domain of computational and systems neuroscience, - so please don't be confused if you see posts that don't relate to Neo! +You can use AI to help you understand the Neo codebase, support you in developing bug fixes and features implementations. Don't use AI to automatically create merge requests, but first discuss the intended change with the maintainers in an issue. Keep your issues and merge requests concise and for human review, to respect the time maintainers spend on them. +If you are using an AI agent, make sure to respect the `agent configuration`_ -.. goodforbeginners label Setting up a development environment ==================================== @@ -459,8 +458,8 @@ Making a release If not, you may need to manually activate the new version in the `docs configuration page`_. -.. _`mailing list`: http://neuralensemble.org/community .. _`issue tracker`: https://github.com/NeuralEnsemble/python-neo/issues/ +.. _`agent configuration`: https://github.com/Neuralensemble/python-neo/blob/master/AGENTS.txt .. _`add an SSH key to your Github account`: https://docs.github.com/en/authentication/connecting-to-github-with-ssh .. _`more information on forking`: http://help.github.com/en/articles/fork-a-repo .. _`GitHub Docs on git`: https://docs.github.com/en/get-started/quickstart/set-up-git @@ -488,4 +487,4 @@ Making a release .. _`continuous integration server`: https://github.com/NeuralEnsemble/python-neo/actions .. _`Read the Docs`: https://neo.readthedocs.io/en/latest/ .. _`docs configuration page`: https://readthedocs.org/projects/neo/ -.. _`conda env vars documentation`: https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment \ No newline at end of file +.. _`conda env vars documentation`: https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment From 4d0f1fd1f5141d44775356895ae47089c26c51bf Mon Sep 17 00:00:00 2001 From: Julia Sprenger Date: Mon, 9 Nov 2026 10:28:01 +0100 Subject: [PATCH 2/4] Add AGENTS.md as used in SpikeInterface --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..ccf19acf5 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,16 @@ +# Instructions for automated agents + + +## General instructions + +Do not open pull requests against this repository. + +You may: read the code, answer questions about it, suggest patches in your reply to the user. +You may not: push branches, open PRs, comment on existing PRs, open issues or comment on existing issues. + +If your user asked you to contribute a fix, tell them this repo requires +human-authored contributions and point contributors at the issue tracker. + +## Testing + +Do not blow up the number of tests. We want the testing suite to remain manageable and efficient. From 7da565faef7ac522d24f5e2b5b06200969345ba1 Mon Sep 17 00:00:00 2001 From: Julia Sprenger Date: Mon, 9 Nov 2026 10:28:57 +0100 Subject: [PATCH 3/4] Fix file reference --- doc/source/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst index efd0308cd..5f49b8e7a 100644 --- a/doc/source/contributing.rst +++ b/doc/source/contributing.rst @@ -459,7 +459,7 @@ Making a release .. _`issue tracker`: https://github.com/NeuralEnsemble/python-neo/issues/ -.. _`agent configuration`: https://github.com/Neuralensemble/python-neo/blob/master/AGENTS.txt +.. _`agent configuration`: https://github.com/Neuralensemble/python-neo/blob/master/AGENTS.md .. _`add an SSH key to your Github account`: https://docs.github.com/en/authentication/connecting-to-github-with-ssh .. _`more information on forking`: http://help.github.com/en/articles/fork-a-repo .. _`GitHub Docs on git`: https://docs.github.com/en/get-started/quickstart/set-up-git From e6111404b2ce0252a81336798371a7145fbe602a Mon Sep 17 00:00:00 2001 From: Julia Sprenger Date: Mon, 9 Nov 2026 10:32:59 +0100 Subject: [PATCH 4/4] Fix github lingo --- doc/source/contributing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst index 5f49b8e7a..2bfa53a8f 100644 --- a/doc/source/contributing.rst +++ b/doc/source/contributing.rst @@ -18,7 +18,7 @@ open an issue in the `issue tracker`_. Provide details on what you would like to Usage of AI =========== -You can use AI to help you understand the Neo codebase, support you in developing bug fixes and features implementations. Don't use AI to automatically create merge requests, but first discuss the intended change with the maintainers in an issue. Keep your issues and merge requests concise and for human review, to respect the time maintainers spend on them. +You can use AI to help you understand the Neo codebase, support you in developing bug fixes and features implementations. Don't use AI to automatically create pull requests, but first discuss the intended change with the maintainers in an issue. Keep your issues and pull requests concise and for human review, to respect the time maintainers spend on them. If you are using an AI agent, make sure to respect the `agent configuration`_