Skip to content

docs: add Technical Charter and restructure governance documentation - #1664

Open
kriswest wants to merge 2 commits into
finos:mainfrom
kriswest:update-governance-3
Open

docs: add Technical Charter and restructure governance documentation#1664
kriswest wants to merge 2 commits into
finos:mainfrom
kriswest:update-governance-3

Conversation

@kriswest

@kriswest kriswest commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Description

Adds a Technical Charter (CHARTER.md) and restructures the project's governance documentation to align with the FINOS software-project-blueprint standard.

Key changes:

  • CHARTER.md (new) — Defines GitProxy's mission, scope, maintainer structure, IP framework, and amendment process.
  • CONTRIBUTING.md (restructured) — Governance content (roles, contribution rules, voting, dispute resolution) added above the existing development guide. Includes a new Cross-Firm Review clause requiring significant changes (new features, breaking changes) to be approved by a maintainer from a different organisation, while explicitly exempting routine maintenance. Adds a Dispute Resolution process (consensus → community meeting → vote → FINOS tie-break).
  • website/docs/development/contributing.mdx (slimmed) — Governance content removed; page now focuses on contribution mechanics and links to CONTRIBUTING.md and CHARTER.md for governance details.

This is a governance-only change with no code modifications.

Related Issue

Resolves #1660

Checklist

General

Documentation

  • Documentation has been added/updated for any new features

Configuration

  • If configuration schema (config.schema.json) was modified:
    • TypeScript types regenerated (npm run generate-config-types)
    • Schema reference docs regenerated (npm run gen-schema-doc)

Tests

  • Tests have been added/updated for new functionality
  • Unit tests pass (npm test)
  • Linting and formatting pass (npm run lint and npm run format:check)
  • Type checks pass (npm run check-types)

@kriswest
kriswest requested a review from a team as a code owner August 6, 2026 07:20
@netlify

netlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploy Preview for endearing-brigadeiros-63f9d0 ready!

Name Link
🔨 Latest commit 55cf7f0
🔍 Latest deploy log https://app.netlify.com/projects/endearing-brigadeiros-63f9d0/deploys/6a743ff07b371900088a2260
😎 Deploy Preview https://deploy-preview-1664.git-proxy.preview.finos.org
📱 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.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 6, 2026
@codecov

codecov Bot commented Aug 6, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.31%. Comparing base (d68c99a) to head (55cf7f0).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1664      +/-   ##
==========================================
- Coverage   90.40%   90.31%   -0.10%     
==========================================
  Files          88       88              
  Lines        8680     8680              
  Branches     1608     1608              
==========================================
- Hits         7847     7839       -8     
- Misses        802      810       +8     
  Partials       31       31              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Git proxy's governance to latest FINOS standard and formalize agreement reviews

1 participant