Skip to content

docs: add AI contribution governance - #1801

Open
michael-valdron wants to merge 1 commit into
devfile:mainfrom
michael-valdron:ai-governance
Open

michael-valdron wants to merge 1 commit into
devfile:mainfrom
michael-valdron:ai-governance

Conversation

@michael-valdron

@michael-valdron michael-valdron commented Oct 28, 2026 •

Copy link
Copy Markdown
Member

Description of Changes

Document requirements for AI-assisted contributions and link them from contributor guidance and the pull request template.

Related Issue(s)

#1773

Acceptance Criteria

Testing and documentation do not need to be complete in order for this PR to be approved. However, tracking issues must be opened for missing testing/documentation.

New testing and documentation issues can be opened under devfile/api/issues.

You can check the respective criteria below if either of the following is true:

  • There is a separate tracking issue opened and that issue is linked in this PR.
  • Testing/documentation updates are contained within this PR.

If criteria is left unchecked please provide an explanation why.

Tests Performed

Explain what tests you personally ran to ensure the changes are functioning as expected.

How To Test

Instructions for the reviewer on how to test your changes.

Notes To Reviewer

Any notes you would like to include for the reviewer.

Summary by CodeRabbit

  • Documentation
    • Added AI-assisted contribution guidance to the contributor documentation, covering review, quality, security, testing, licensing, intellectual property, attribution, and validation requirements.
    • Added an optional AI Governance checkbox and a link to the governance guidance in the pull request template.
    • Added an AI Governance section to the governance documentation, including guidance on third-party material, uncertain ownership or licensing, and additional project-specific requirements.

Document requirements for AI-assisted contributions and link them from contributor guidance and the pull request template.

Assisted-by: GPT-5 <noreply@openai.com>
Signed-off-by: Michael Valdron <mvaldron@redhat.com>
@coderabbitai

coderabbitai Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: e52ae650-f014-4070-a985-c6f921ed34a8
Commits

Reviewing files that changed from the base of the PR and between 9ef4cfd and 03930e5.

Files selected for processing: 3
  • .github/PULL_REQUEST_TEMPLATE.md
  • CONTRIBUTING.md
  • GOVERNANCE.md

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 1 remain after this review.

Walkthrough

The governance document adds requirements for AI-assisted contributions. The contribution guide and pull request template point contributors to those requirements.

Changes: AI Contribution Guidance

Layer / File(s) Summary
AI contribution governance requirements
GOVERNANCE.md
The governance document adds standards for AI-assisted contributions, contributor checks for tool terms and third-party permissions, attribution requirements, and a link to the Linux Foundation policy.
Contribution and pull request guidance
CONTRIBUTING.md, .github/PULL_REQUEST_TEMPLATE.md
The contribution guide requires AI-assisted contributions to follow the governance requirements. The pull request template adds an optional checkbox that links to those requirements.

Priority: Low

Estimated code review effort: 2 (Simple) | ~5 minutes

Change: Other

Merge Risk: Minimal · up to 03930

This documentation-only change is ready to merge with no identified functional or operational risk.

Pre-merge checks: Passed 5
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly and concisely describes the main change: adding AI contribution governance documentation.
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (3 skipped: 3 unsupported.)

Finishing Touches
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@openshift-ci

openshift-ci Bot commented Oct 28, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: JslYoon, michael-valdron

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants