matrix-org / matrix-org/matrix-spec

Consider a subspec of some kind for standardizing X over Matrix, where X isn't really core

Open
#1,064 0 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

*I'm certain we have an issue for this, but I can't find it.*

We have several ideas of things which might be standardized using Matrix so other Matrix consumers can integrate safely and efficiently, however adopting them into the core specification is awkward at best.

So, what if we just made them a subspec of some variety? We'd link to them from spec.matrix.org somehow (maybe even manage them under the matrix-spec repo itself), and consider them something people can submit MSCs to, etc.

Open questions we've thought about loosely but don't have answers to are:
* Who owns these "vendored specs"? Is the SCT really in the best position to talk about 3D worlds, or should that be someone else? Do we need to formalize committees within the Foundation?
* How are changes made to these specs? MSCs?
* What do they look like? Where do we draw the line? What don't we want to accept, if anything?

**We are not expecting answers to these at this point, and honestly wouldn't expect feedback until a draft MSC was put up.**

Current examples:
* State counters used by element-web
* https://github.com/matrix-org/matrix-spec/issues/973
* https://github.com/matrix-org/matrix-spec-proposals/pull/3815
* https://github.com/matrix-org/matrix-spec/blob/main/informal/idp-brands.md

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the linked examples: state counters in element-web, issue 973, pull request 3815, and informal/idp-brands.md. Done would be a draft MSC that defines the proposed subspec model, including ownership, change process, scope, and acceptance boundaries.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.