Menu ▾ ▴

#217 AI policy

None
open
nobody
None
5
5 hours ago
5 hours ago
No

I suggest to add the following paragraph about copyright responsibilities and section about use of AI for contributions to Docutils to the "Docutils Project Policies".

It is an adapted and shortened version of the Sphinx AI policy which itself is based on the AI policy of NumPy and SciPy which are based on SymPy's AI Generated Code and Communication Policy.

--- a/docutils/docs/dev/policies.rst
+++ b/docutils/docs/dev/policies.rst
@@ -153,6 +153,11 @@ the project for inclusion (via Subversion, SourceForge trackers,
mailing lists, or private email) are assumed to be in the public
domain as well.

+Contributors must ensure their contribution does not infringe on the
+copyright of others and reference the copyright holder and license of
+code parts under a compatible open-source license. We reserve the right
+to reject any contributions where the copyright is in question.
+
Any new files contributed to the project should clearly state their
intentions regarding copyright, in one of the following ways:

@@ -177,6 +182,58 @@ intentions regarding copyright, in one of the following ways:
__ ../../licenses/BSD-2-Clause.rst

+AI Policy
+=========
+
+All contributors must disclose whether AI [#ai]_ has been used to assist in
+the development of their contributions. If so, they must document which
+tool(s) have been used, how they were used, and specify what code or text
+is AI generated.
+We will reject contributions without accompanying AI disclosure.
+
+The use of an AI agent that writes code and then submits a patch
+autonomously is not permitted. A human must check any generated code and
+submit the patch. Please do not waste developers' time by submitting
+code that is fully or mostly generated by AI and doesn't meet our
+standards.
+
+Contributors are responsible for any code they submit for inclusion
+in Docutils, regardless of whether it was manually written or generated
+by AI. They must understand and be able to explain the submitted code as
+well as the existing related code. It is not acceptable to submit a patch
+that is not understood or cannot be explained by the submitter.
+When documenting the contribution, do not use AI to automatically generate
+comments or issue descriptions or update the user documentation.
+
+.. sidebar:: Further Reading
+

Repository

--- a/docutils/docs/dev/policies.rst
+++ b/docutils/docs/dev/policies.rst
@@ -153,6 +153,11 @@ the project for inclusion (via Subversion, SourceForge trackers,
 mailing lists, or private email) are assumed to be in the public
 domain as well.

+Contributors must ensure their contribution does not infringe on the
+copyright of others and reference the copyright holder and license of
+code parts under a compatible open-source license.  We reserve the right
+to reject any contributions where the copyright is in question.
+
 Any new files contributed to the project should clearly state their
 intentions regarding copyright, in one of the following ways:

@@ -177,6 +182,58 @@ intentions regarding copyright, in one of the following ways:
 __ ../../licenses/BSD-2-Clause.rst


+AI Policy
+=========
+
+All contributors must disclose whether AI [#ai]_ has been used to assist in
+the development of their contributions.  If so, they must document which
+tool(s) have been used, how they were used, and specify what code or text
+is AI generated.
+We will reject contributions without accompanying AI disclosure.
+
+The use of an AI agent that writes code and then submits a patch
+autonomously is not permitted.  A human must check any generated code and
+submit the patch.  Please do not waste developers' time by submitting
+code that is fully or mostly generated by AI and doesn't meet our
+standards.
+
+Contributors are responsible for any code they submit for inclusion
+in Docutils, regardless of whether it was manually written or generated
+by AI. They must understand and be able to explain the submitted code as
+well as the existing related code.  It is not acceptable to submit a patch
+that is not understood or cannot be explained by the submitter.
+When documenting the contribution, do not use AI to automatically generate
+comments or issue descriptions or update the user documentation.
+
+.. sidebar:: Further Reading
+

+  - `Sphinx AI policy
+    <https://www.sphinx-doc.org/en/master/internals/ai-policy.html>`_
+  - `LLVM AI tool policy <https://llvm.org/docs/AIToolPolicy.html>`_
+  - `Open source AI contribution policies
+    <https://github.com/melissawm/open-source-ai-contribution-policies>`_
+  - `Scientific Python community considerations around AI
+    <https://blog.scientific-python.org/scientific-python/
+    community-considerations-around-ai/>`_
+  - `Python developer's guide to AI tools
+    <https://devguide.python.org/getting-started/ai-tools/index.html>`_
+
+When interacting with the maintainers (forums, discussions, issues, etc.)
+do not use AI to speak for you, except for translation or grammar
+editing. If the developers want to chat with a chatbot, they can do so
+themselves. Human-to-human communication is essential for an open source
+community to thrive.
+
+We thank the SymPy developers, whose `AI Generated Code and Communication
+Policy`__ this section was adapted from.
+
+.. [#ai] "AI" herein refers to generative AI tools like large language
+   models (LLMs) that can generate, edit, and review software code,
+   images, or texts.
+
+__ https://docs.sympy.org/dev/contributing/ai-generated-code-policy.html
+
+
 .. _Subversion Repository:

 Repository

Discussion

  • Günter Milde

    Günter Milde - 5 hours ago
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -1,4 +1,82 @@
    -I suggest to add the following paragraph about copyright responsibilities and section about use of AI for contributions to Docutils to the &#34;Docutils Project Policies&#34;:
    +I suggest to add the following paragraph about copyright responsibilities and section about use of AI for contributions to Docutils to the &#34;Docutils Project Policies&#34;.
    +
    +It is an adapted and shortened version of the Sphinx AI policy which itself is based on the AI policy of NumPy and SciPy which are based on SymPy&#39;s [AI Generated Code and Communication
    ++Policy](https://docs.sympy.org/dev/contributing/ai-generated-code-policy.html).
    +
    +--- a/docutils/docs/dev/policies.rst
    ++++ b/docutils/docs/dev/policies.rst
    +@@ -153,6 +153,11 @@ the project for inclusion (via Subversion, SourceForge trackers,
    
    + mailing lists, or private email) are assumed to be in the public
    + domain as well.
    + 
    ++Contributors must ensure their contribution does not infringe on the
    ++copyright of others and reference the copyright holder and license of
    ++code parts under a compatible open-source license.  We reserve the right
    ++to reject any contributions where the copyright is in question.
    ++
    + Any new files contributed to the project should clearly state their
    + intentions regarding copyright, in one of the following ways:
    + 
    +@@ -177,6 +182,58 @@ intentions regarding copyright, in one of the following ways:
    + __ ../../licenses/BSD-2-Clause.rst
    + 
    + 
    ++AI Policy
    ++=========
    ++
    ++All contributors must disclose whether AI [#ai]_ has been used to assist in
    ++the development of their contributions.  If so, they must document which
    ++tool(s) have been used, how they were used, and specify what code or text
    ++is AI generated.
    ++We will reject contributions without accompanying AI disclosure.
    ++
    ++The use of an AI agent that writes code and then submits a patch
    ++autonomously is not permitted.  A human must check any generated code and
    ++submit the patch.  Please do not waste developers&#39; time by submitting
    ++code that is fully or mostly generated by AI and doesn&#39;t meet our
    ++standards.
    ++
    ++Contributors are responsible for any code they submit for inclusion
    ++in Docutils, regardless of whether it was manually written or generated
    ++by AI. They must understand and be able to explain the submitted code as
    ++well as the existing related code.  It is not acceptable to submit a patch
    ++that is not understood or cannot be explained by the submitter.
    ++When documenting the contribution, do not use AI to automatically generate
    ++comments or issue descriptions or update the user documentation.
    ++
    ++.. sidebar:: Further Reading
    ++
    ++  - `Sphinx AI policy
    ++    &lt;https://www.sphinx-doc.org/en/master/internals/ai-policy.html&gt;`_
    ++  - `LLVM AI tool policy &lt;https://llvm.org/docs/AIToolPolicy.html&gt;`_
    ++  - `Open source AI contribution policies
    ++    &lt;https://github.com/melissawm/open-source-ai-contribution-policies&gt;`_
    ++  - `Scientific Python community considerations around AI
    ++    &lt;https://blog.scientific-python.org/scientific-python/
    ++    community-considerations-around-ai/&gt;`_
    ++  - `Python developer&#39;s guide to AI tools
    ++    &lt;https://devguide.python.org/getting-started/ai-tools/index.html&gt;`_
    ++
    ++When interacting with the maintainers (forums, discussions, issues, etc.)
    ++do not use AI to speak for you, except for translation or grammar
    ++editing. If the developers want to chat with a chatbot, they can do so
    ++themselves. Human-to-human communication is essential for an open source
    ++community to thrive.
    ++
    ++We thank the SymPy developers, whose `AI Generated Code and Communication
    ++Policy`__ this section was adapted from.
    ++
    ++.. [#ai] &#34;AI&#34; herein refers to generative AI tools like large language
    ++   models (LLMs) that can generate, edit, and review software code,
    ++   images, or texts.
    ++
    ++__ https://docs.sympy.org/dev/contributing/ai-generated-code-policy.html
    ++
    ++
    + .. _Subversion Repository:
    + 
    + Repository
    +
     ~~~ diff
     --- a/docutils/docs/dev/policies.rst
     +++ b/docutils/docs/dev/policies.rst
    
     
  • Günter Milde

    Günter Milde - 5 hours ago
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -1,7 +1,6 @@
     I suggest to add the following paragraph about copyright responsibilities and section about use of AI for contributions to Docutils to the &#34;Docutils Project Policies&#34;.
    
    -It is an adapted and shortened version of the Sphinx AI policy which itself is based on the AI policy of NumPy and SciPy which are based on SymPy&#39;s [AI Generated Code and Communication
    -+Policy](https://docs.sympy.org/dev/contributing/ai-generated-code-policy.html).
    +It is an adapted and shortened version of the Sphinx AI policy which itself is based on the AI policy of NumPy and SciPy which are based on SymPy&#39;s [AI Generated Code and Communication Policy](https://docs.sympy.org/dev/contributing/ai-generated-code-policy.html).
    
     --- a/docutils/docs/dev/policies.rst
     +++ b/docutils/docs/dev/policies.rst
    
     

Log in to post a comment.