Skip to content

Details on goverance of the project#838

Open
neerajnv wants to merge 3 commits intoNVIDIA:mainfrom
neerajnv:main
Open

Details on goverance of the project#838
neerajnv wants to merge 3 commits intoNVIDIA:mainfrom
neerajnv:main

Conversation

@neerajnv
Copy link

@neerajnv neerajnv commented Feb 16, 2026

Summary

Type of Change

  • 🐛 Bug fix
  • ✨ New feature
  • 💥 Breaking change
  • 📚 Documentation
  • 🔧 Refactoring
  • 🔨 Build/CI

Component(s) Affected

  • Core Services
  • Documentation/CI
  • Fault Management
  • Health Monitors
  • Janitor
  • Other: ____________

Testing

  • Tests pass locally
  • Manual testing completed
  • No breaking changes (or documented)

Checklist

  • Self-review completed
  • Documentation updated (if needed)
  • Ready for review

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive governance policy describing roles (Contributors, Reviewers, Approvers, Maintainers, Technical Leads), responsibilities, privileges, and paths for advancement.
    • Defined decision-making and escalation processes for code changes, design/architecture, ownership, conflict resolution, and release management.
    • Documented maintenance requirements, modification procedures, contribution guidelines, and contact/sponsorship alignment.

@copy-pr-bot
Copy link

copy-pr-bot bot commented Feb 16, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 16, 2026

📝 Walkthrough

Walkthrough

Adds a standalone NVSentinel governance policy defining hierarchical roles (Contributors, Reviewers, Approvers, Maintainers, Technical Leads/Project Chairs), responsibilities and privileges, decision-making and escalation processes for code and architecture, areas of ownership, role advancement paths, release and modification procedures, and contact guidance. (49 words)

Changes

Cohort / File(s) Summary
Governance Documentation
GOVERNANCE.md
New comprehensive governance policy added: role definitions and criteria, decision-making processes for code/design, conflict resolution and escalation paths, areas of ownership, paths to become Reviewer/Approver, maintenance and release management rules, modification procedure, and contact information.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 I hopped through rules and roles anew,

I mapped the paths for what contributors do,
From reviewer checks to chairs who steer,
A governance burrow, orderly and clear,
NVSentinel blooms — I nibble and cheer! 🥕

🚥 Pre-merge checks | ✅ 3 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title contains a typo ('goverance' instead of 'governance') and is somewhat vague about the specific governance content being added. Correct the typo to 'governance' and consider making the title more specific, such as 'Add comprehensive governance documentation with role definitions and decision processes'.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into main

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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 and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@GOVERNANCE.md`:
- Around line 124-135: The Pull Request Process and Review Requirements sections
are inconsistent about who must approve PRs; update the GOVERNANCE.md text so
roles and actions are precise and non-contradictory: either change the general
rule in the "Pull Request Process" section to read "All pull requests require at
least one review from an Approver or Reviewer" (or "at least one review" if you
want reviews only) or change the "Small changes" line in "Review Requirements"
to require "1 Approver approval" instead of "1 Reviewer approval"; ensure you
reference the section headers "Pull Request Process" and "Review Requirements"
and the phrases "All pull requests require at least one review/approval" and
"Small changes (documentation, typo fixes): 1 Reviewer approval" when making the
edit so terminology matches role capabilities (Reviewer vs Approver).
🧹 Nitpick comments (2)
GOVERNANCE.md (2)

7-7: Hyphenate compound adjective.

"High quality" should be hyphenated when used as a compound adjective before a noun: "high-quality standards".

📝 Suggested fix
-NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high quality standards while remaining accessible to new contributors.
+NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high-quality standards while remaining accessible to new contributors.

215-220: Consider documenting current role holders.

The governance document clearly defines roles and responsibilities but doesn't specify who currently holds each role. Consider either:

  1. Adding a section listing current Maintainers, Technical Leads, and area-specific Approvers/Reviewers, or
  2. Pointing to where this information is maintained (e.g., a MAINTAINERS.md file, GitHub teams page, or project website)

This would improve transparency and help contributors know who to contact for specific areas.

Signed-off-by: nkapoor <nkapoor@nvidia.com>
This reverts commit 185cf55.

Signed-off-by: nkapoor <nkapoor@nvidia.com>
Signed-off-by: nkapoor <nkapoor@nvidia.com>
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@GOVERNANCE.md`:
- Line 7: Replace the unhyphenated compound adjective "high quality standards"
in the sentence inside GOVERNANCE.md with the hyphenated form "high-quality
standards" so the phrase reads "maintains high-quality standards" to follow
grammar rules for compound adjectives before nouns.


## Overview

NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high quality standards while remaining accessible to new contributors.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Hyphenate the compound adjective.

“high quality standards” should be “high-quality standards.”

✍️ Suggested edit
-NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high quality standards while remaining accessible to new contributors.
+NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high-quality standards while remaining accessible to new contributors.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high quality standards while remaining accessible to new contributors.
NVSentinel follows a hierarchical governance model similar to other Kubernetes ecosystem projects. This structure ensures that contributions are properly reviewed, architectural decisions are well-considered, and the project maintains high-quality standards while remaining accessible to new contributors.
🧰 Tools
🪛 LanguageTool

[grammar] ~7-~7: Use a hyphen to join words.
Context: ...nsidered, and the project maintains high quality standards while remaining access...

(QB_NEW_EN_HYPHEN)

🤖 Prompt for AI Agents
In `@GOVERNANCE.md` at line 7, Replace the unhyphenated compound adjective "high
quality standards" in the sentence inside GOVERNANCE.md with the hyphenated form
"high-quality standards" so the phrase reads "maintains high-quality standards"
to follow grammar rules for compound adjectives before nouns.

@XRFXLP
Copy link
Member

XRFXLP commented Feb 16, 2026

/ok to test 7e988ba

@NVIDIA NVIDIA deleted a comment from copy-pr-bot bot Feb 16, 2026
- Can participate in release planning and decisions

**How to become one**:
1. Be an active Reviewer for at least 3 months
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think one of the criteria should also be to deliver a feature end to end starting from design

- Can manage project settings and repositories

**How to become one**:
1. Be an active Approver for at least 6 months
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should also some more details on what it means to be active, i.e., features contributed, PRs reviewed etc

### Design and Architecture Decisions

1. **Proposal Process**:
- Create a GitHub Discussion or issue with the `design` label
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if we have this label

1. **Proposal Process**:
- Create a GitHub Discussion or issue with the `design` label
- Tag relevant Maintainers and Approvers
- Allow at least 1 week for community feedback
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 week I think is a bit too long. For a project that is pre-alpha, I think we should be in a position to rapidly iterate

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants