Skip to content

Add governance page and links from homepage#253

Open
poshul wants to merge 9 commits intomainfrom
add_governance
Open

Add governance page and links from homepage#253
poshul wants to merge 9 commits intomainfrom
add_governance

Conversation

@poshul
Copy link
Contributor

@poshul poshul commented Mar 6, 2026

Add description of the interplay between OpenMS inc and the executive Committee.

Summary by CodeRabbit

  • New Features

    • Added "Core Developers", "Executive committee", and "Governance" links in footer navigation.
    • Added "Help" to footer; updated About Us sublinks to surface Governance.
  • Documentation

    • Added Governance, Executive Committee, Core Developers, and Onboarding pages.
    • Updated Contributors page link to point to the Executive Committee info.

@netlify
Copy link

netlify bot commented Mar 6, 2026

Deploy Preview for openms ready!

Name Link
🔨 Latest commit 719bf0b
🔍 Latest deploy log https://app.netlify.com/projects/openms/deploys/69aaf7417742250008e096af
😎 Deploy Preview https://deploy-preview-253--openms.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 6, 2026

📝 Walkthrough

Walkthrough

Adds governance documentation (Core Developers, Executive Committee, Governance), updates navbar and footer links to reference these pages, and updates contributor link to point to the Executive Committee page.

Changes

Cohort / File(s) Summary
Navigation Configuration
config.yaml
Footer: added "Core Developers" in column2; replaced column3 entry with "Executive committee" and "Governance"; moved/added "Help" to column4. Navbar: "About Us" sublinks now use "Governance" instead of "OpenMS Inc."
Governance Documentation
content/en/core_developers.md, content/en/exec_committee.md, content/en/governance.md, content/en/onboarding.md
Added detailed governance and onboarding docs: roles, responsibilities, voting rules, meeting procedures, merge practices, onboarding and transparency guidelines.
Content Update
content/en/contributors.md
Replaced link to /about with /exec_committee for the Executive Committee reference.

Possibly related PRs

Poem

🐰 I hopped through pages, bright and new,
Governance paths laid out in view,
Core devs, committees, links now clear,
A tidy warren—welcome here! 🌿

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description is minimal but relevant; however, it lacks detail about the comprehensive scope of changes including new documentation files (core_developers.md, exec_committee.md, onboarding.md) and configuration updates. Expand the description to detail all added documentation files, navigation changes, and link updates to give reviewers a complete understanding of the changeset scope.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: adding a governance page and updating homepage links to reference it.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ 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
  • Commit unit tests in branch add_governance

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: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@content/governance.md`:
- Line 105: The heading "## 7. Relationship Between OpenMS Inc. and the OpenMS
Executive Committee" includes a stray "7." that should be removed to match other
unnumbered peer sections; update the heading text (the Markdown heading for
"Relationship Between OpenMS Inc. and the OpenMS Executive Committee") to "##
Relationship Between OpenMS Inc. and the OpenMS Executive Committee" so the
document and TOC render consistently.
- Around line 1-127: The governance page file must be relocated so the site
generator finds it: move the markdown currently at content/governance.md into
content/en/governance.md (matching the languages.en.contentDir setting in
config.yaml); after moving, verify any internal relative links or navigation
entries pointing to /governance still resolve and update them if necessary.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 823486d8-8ce7-487f-88ee-8e7ae18bc124

📥 Commits

Reviewing files that changed from the base of the PR and between 2c22377 and 93b3811.

📒 Files selected for processing (2)
  • config.yaml
  • content/governance.md

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: 2

🧹 Nitpick comments (1)
content/en/contributors.md (1)

14-14: Use descriptive link text instead of “here”.

This reads fine, but generic anchor text is harder to scan and less accessible. Something like “see the [Executive Committee page]” would be clearer.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@content/en/contributors.md` at line 14, Replace the non-descriptive anchor
text "[here]({{< relref \"/exec_committee\" >}})" with a descriptive label such
as "[Executive Committee page]({{< relref \"/exec_committee\" >}})" (or
"[Executive Committee]") so the link text clearly identifies the target; update
the line containing the relref reference accordingly to improve clarity and
accessibility.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@config.yaml`:
- Around line 157-158: The footer link "link: /core-developers" points to a URL
that doesn't match the new page filename core_developers; either add slug:
core-developers to the front matter of content/en/core_developers.md so Hugo
publishes it at /core-developers, or change the footer entry in config.yaml from
link: /core-developers to link: /core_developers so it matches the generated
URL; update whichever file you choose (the front matter in
content/en/core_developers.md or the footer block in config.yaml) and ensure
governance.md links remain consistent.

In `@content/en/exec_committee.md`:
- Around line 47-50: The phrase "by request of the member themself" under the
"Removal of Core Developers" heading reads awkwardly; replace "themself" with a
grammatically correct alternative such as "themselves" or simplify to "by
request of the member" so the sentence reads e.g. "or by request of the member
themselves" (or "or by request of the member") to improve clarity and tone.

---

Nitpick comments:
In `@content/en/contributors.md`:
- Line 14: Replace the non-descriptive anchor text "[here]({{< relref
\"/exec_committee\" >}})" with a descriptive label such as "[Executive Committee
page]({{< relref \"/exec_committee\" >}})" (or "[Executive Committee]") so the
link text clearly identifies the target; update the line containing the relref
reference accordingly to improve clarity and accessibility.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9d4c0393-4692-4a65-bd16-4b33e5ea7539

📥 Commits

Reviewing files that changed from the base of the PR and between 2930a23 and a590e96.

📒 Files selected for processing (5)
  • config.yaml
  • content/en/contributors.md
  • content/en/core_developers.md
  • content/en/exec_committee.md
  • content/en/governance.md

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.

🧹 Nitpick comments (1)
content/en/onboarding.md (1)

55-55: Heading level skips from h1 to h3.

Under the # Communication section (line 49), subsections like ### GitHub Issues jump directly to h3, skipping h2. The same pattern occurs at line 104 under # Development Workflow. For proper semantic structure and accessibility, consider using ## for these subsections.

📝 Suggested fix for heading hierarchy
-### GitHub Issues
+## GitHub Issues

Apply the same change to ### GitHub Pull Requests, ### Discord, ### Project Meetings, ### Reporting Issues, ### Submitting Changes, and ### Code Review.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@content/en/onboarding.md` at line 55, Several section headings under "#
Communication" and "# Development Workflow" use "###" (h3) and skip h2; change
those to "##" to restore proper heading hierarchy: update the headings titled
"GitHub Issues", "GitHub Pull Requests", "Discord", "Project Meetings",
"Reporting Issues", "Submitting Changes", and "Code Review" from "###" to "##"
so they sit directly under their parent H1 sections and maintain semantic
structure and accessibility.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@content/en/onboarding.md`:
- Line 55: Several section headings under "# Communication" and "# Development
Workflow" use "###" (h3) and skip h2; change those to "##" to restore proper
heading hierarchy: update the headings titled "GitHub Issues", "GitHub Pull
Requests", "Discord", "Project Meetings", "Reporting Issues", "Submitting
Changes", and "Code Review" from "###" to "##" so they sit directly under their
parent H1 sections and maintain semantic structure and accessibility.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f57a719f-3c73-4cbc-8916-eb5d2127b396

📥 Commits

Reviewing files that changed from the base of the PR and between a590e96 and 719bf0b.

📒 Files selected for processing (3)
  • config.yaml
  • content/en/exec_committee.md
  • content/en/onboarding.md

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.

1 participant