You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is a small, clean documentation-only PR that adds a new automated_tools.md page to the gh-pages contributor guide, establishing guidelines for AI-assisted contributions. It also updates index.md to register the new page in the toctree and topic list. The change is well-scoped and the content is reasonable. This appears to be the gh-pages companion to #10176 (targeting develop) and #10178 (targeting v2) by the same contributor.
Blocking Issues
None.
Non-blocking Suggestions
Duplication / DRY concern across branches: The content of automated_tools.md is nearly identical to what PR chore: add additional text to CONTRIBUTING.md #10176 adds to CONTRIBUTING.md on develop. If the gh-pages site is auto-generated from develop, this PR may be overwritten or cause conflicts once chore: add additional text to CONTRIBUTING.md #10176 merges. If gh-pages is independently maintained, the duplication is fine — but worth a note in the PR description to clarify the intent.
Toctree placement: automated_tools is placed between testing and support in the toctree. This is a reasonable spot, though another natural location could be right after contribution_process since the automated tools policy is fundamentally a contribution guideline. Minor either way.
Escaped angle brackets (\<person\> in automated_tools.md line 10): Verify this renders as intended with the specific static site generator used for gh-pages (e.g., Sphinx with MyST). Some renderers may treat \< differently.
Questions / Clarifications
Is gh-pages manually maintained or auto-built? If this branch is auto-generated (e.g., from a Sphinx/docs build in CI), this PR would be overwritten on the next build cycle. The PR description should clarify this.
Self-compliance: The PR adds guidelines requiring AI-sourced submissions to include a statement like "generated by AI tools, and reviewed by <person>". If this content was AI-assisted, it should follow its own rules.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description of changes:
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.