Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
#### Description
<!-- Provide a concise overview of the issue or rationale behind the proposed changes. -->

#### AI Assistance Disclosure
<!-- Please select exactly ONE of the following: -->
- [ ] **No AI tools were used** in preparing this PR.
- [ ] **If AI tools were used**, I have disclosed which ones, and fully reviewed and verified their output.

#### Checklist
- [ ] This PR follows the [contribution guidelines](https://python-markdown.github.io/contributing/).
- [ ] The code follows the [Code Style Guide](https://python-markdown.github.io/contributing/#code-style-guide).
- [ ] The commit message follows the [Commit Message Style Guide](https://python-markdown.github.io/contributing/#commit-message-style-guide).
- [ ] I have added or updated relevant docs, including release notes if applicable which follow the [Documentation Style Guide](Documentation Style Guide).
- [ ] I have added or updated relevant tests.
- [ ] I have not requested, and will not request, an automated AI review for this PR. <!-- You are welcome to do so in your own fork. -->
1 change: 1 addition & 0 deletions .spell-dict
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ Altmayer
API
Artem
aspell
Astropy
Babelmark
backtick
backticks
Expand Down
41 changes: 41 additions & 0 deletions docs/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,46 @@ series of commits along with the discussion about those changes as they
progress over time. If your pull request is accepted, it will be squashed at
that time if deemed appropriate.

## AI Contributions

Contributions to the Python-Markdown project are welcome, including those
developed with the assistance of generative AI tools. However, the use of
such tools does not change expectations for contributor responsibility,
engagement, or code quality. The following apply to all contributions.

Contributors are responsible for all submitted content, regardless of whether
generative AI tools were used.

Contributors must be able to explain all changes upon request during review.

Contributors are responsible for ensuring all submitted code complies with
Python-Markdown's licensing, regardless of whether generative AI tools were
used.

The pull request process should be collaborative and iterative. Contributors
are expected to actively engage with reviewer feedback themselves.
Contributors are expected to understand the changes they are proposing, not
act as a message courier for a third party. Copying and pasting replies to /
from a generative AI tool does not count as engaging with the reviewer. The
use of an AI agent to submit a pull request, issue, or comment autonomously
is not permitted.

All code and prose (documentation, commit messages, comments, etc.) must
reflect the style and conventions used by the Python-Markdown project (see
[Code Style Guide](#code-style-guide), [Documentation Style
Guide](#documentation-style-guide), and [Commit Message Style
Guide](#commit-message-style-guide) below).

Maintainers may close issues and pull requests that are not useful or
productive, regardless of whether AI tools were used or not. If a contributor
repeatedly opens unproductive issues or requests, they may be blocked from
contributing to the project as it is disruptive and disrespectful of the
maintainers' time.

!!! Note
This policy was largely inspired by the Astropy Project's
[Usage of Generative AI] policy.

## Style Guides

In an effort to maintain consistency, Python-Markdown adheres to the following
Expand Down Expand Up @@ -577,6 +617,7 @@ for details.
[Babelmark]: https://johnmacfarlane.net/babelmark2/
[Creating a pull request from a fork]: https://help.github.com/articles/creating-a-pull-request-from-a-fork/
[action words]: https://help.github.com/articles/closing-issues-using-keywords/
[Usage of Generative AI]: https://github.com/astropy/astropy-project/blob/b842b9bef3c8d69da73d639ea0254ae17fbc1fd1/policies/ai-policy.md
[PEP8 Style Guide]: https://www.python.org/dev/peps/pep-0008/
[Flake8]: http://flake8.pycqa.org/en/latest/index.html
[Markdown]: https://daringfireball.net/projects/markdown/basics
Expand Down
Loading