Skip to content

Document how MXC is managed - #1593

Merged
Branden Bonaby (bbonaby) merged 3 commits into
mainfrom
user/bbonaby/repository-management-guide
Oct 27, 2026
Merged

Branden Bonaby (bbonaby) merged 3 commits into
mainfrom
user/bbonaby/repository-management-guide

Conversation

@bbonaby

@bbonaby Branden Bonaby (bbonaby) commented Oct 27, 2026 •

Copy link
Copy Markdown
Collaborator

📖 Description

Add a public guide explaining how MXC is managed:

  • Daily developer/PM triage, primary and supporting area contacts, issue follow-up, and implementation assignment.
  • Contribution and review expectations, milestone readiness, twice-monthly release targets, and community prioritization.
  • Semantic Versioning 2.0.0, independent SDK/schema versions, and fixes shipping on the current release line rather than through backports.

Link the guide from CONTRIBUTING and the developer index, and align the existing versioning guidance. This is documentation only; it does not change runtime behavior, SDK APIs, schemas, CI, or automation.

🔗 References

🔍 Validation

  • git diff --check origin/main...HEAD — passed.
  • Manually checked the changed documentation links and confirmed the PR contains only the four intended Markdown files.
  • Runtime builds and tests were not run because this is documentation only.

✅ Checklist

📋 Issue Type

  • Bug fix
  • Feature
  • Task

GitHub Actions runs the PR validation build automatically. The ADO pipeline
(MXC-PR-Build) is the Azure version of the PR pipeline, kept in parity with the GitHub
Actions build; it runs on merge to main, and Microsoft reviewers with write access can trigger it
on a PR with /azp run. See pull request builds.

If the dependency-feed-check check fails on a new dependency, the crate must be added to
the feed before the PR can pass. See pull request builds
for the steps.

Microsoft Reviewers: Open in CodeFlow

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3e7c7c53-21df-41fa-9268-93af2b6824b3
@bbonaby
Branden Bonaby (bbonaby) requested a review from a team as a code owner October 27, 2026 17:34
Copilot AI balanced review requested due to automatic review settings October 27, 2026 17:34
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

The documentation-only changes leave runtime behavior untouched, with only a non-blocking clarification remaining.

No open issues 🎉

What changed in this PR

Adds a public guide to MXC’s maintenance and contribution process, linking it from contributor documentation and aligning release-versioning guidance. Changes are documentation-only.

Changes:

  • Documents triage, area ownership, contribution reviews, and community prioritization.
  • Explains milestone readiness, twice-monthly release targets, and the no-backport policy.
  • Clarifies Semantic Versioning and independent SDK/schema versions.
File Description
docs/​repository-management.md Adds the public maintenance and release-policy guide.
docs/​development/​README.md Links the guide from the contributor index.
docs/​development/​architecture/​versioning.md Aligns versioning and release-line guidance.
CONTRIBUTING.md Updates triage guidance and links the management guide.

Review effort: Balanced

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3e7c7c53-21df-41fa-9268-93af2b6824b3
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3e7c7c53-21df-41fa-9268-93af2b6824b3

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

The documentation-only changes have no blocking defects; the remaining assignment-wording clarification is minor.

No open issues 🎉

Review effort: Balanced

@bbonaby
Branden Bonaby (bbonaby) merged commit 3a80628 into main Oct 27, 2026
31 checks passed
@bbonaby
Branden Bonaby (bbonaby) deleted the user/bbonaby/repository-management-guide branch October 27, 2026 20:21
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.

Document how MXC is managed

3 participants