matrix-spec-proposals

Proposals for changes to the matrix specification

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Keyvan Fatehi 94565933c2 Tempering the sales pitch of puppetted bridges. Folks are getting confused. The article sells the puppeted bridge concept a little too hard and needs to temper it with the reality that most networks people want to bridge (Facebook, Hangouts) suffer from the fact that there is no means of representation for non-puppeted users. Relevant discussions: * https://matrix.to/#/!ChuQQIVJvwyJujhNIG:synapse.keyvan.pw/$149063160814JjbEL:gruenhage.xyz * https://matrix.to/#/!svJUttHBtRMdXmEhEy:matrix.org/$149072185910105qOwCB:synapse.keyvan.pw Signed-off-by: Keyvan Fatehi <keyvanfatehi@gmail.com>		7 years ago
api	Merge pull request #740 from matrix-org/rav/fix_736	8 years ago
attic	Consistently spell homeserver as homeserver	9 years ago
changelogs	Allow guest access to E2E endpoints	8 years ago
drafts	delete macaroons draft	8 years ago
event-schemas	Clarify that age is generated on the local HS	8 years ago
meta	Link to doc style doc	8 years ago
scripts	Add continuserv index	8 years ago
specification	Specification of unpadded Base64	7 years ago
supporting-docs	Tempering the sales pitch of puppetted bridges.	7 years ago
templating	Better examples	8 years ago
.gitignore	Dump-swagger: take output file name rather than output dir	8 years ago
CONTRIBUTING.rst	Link to doc style doc	8 years ago
LICENSE	Add a license to the spec	8 years ago
README.rst	Update README	8 years ago
jenkins.sh	Remove thing from jenkins.sh	8 years ago

README.rst

This repository contains the documentation for Matrix.

Structure
=========

- ``api`` : Contains the HTTP API specification.
- ``attic``: Contains historical sections of specification for reference
  purposes.
- ``changelogs``: Contains change logs for the various parts of the
  specification.
- ``drafts``: Previously, contained documents which were under discussion for
  future incusion into the specification and/or supporting documentation. This
  is now historical, as we use separate discussion documents (see
  `<CONTRIBUTING.rst>`_).
- ``event-schemas``: Contains the `JSON Schema`_ for all Matrix events
  contained in the specification, along with example JSON files.
- ``meta``: Contains documents outlining the processes involved when writing
  documents, e.g. documentation style, guidelines.
- ``scripts``: Contains scripts to generate formatted versions of the
  documentation, typically HTML.
- ``specification``: Contains the specification split up into sections.
- ``supporting-docs``: Contains additional documents which explain design
  decisions, examples, use cases, etc.
- ``templating``: Contains the templates and templating system used to
  generate the spec.

Contributing
============

Known issues with the specification are represented as JIRA issues at
`<https://matrix.org/jira/browse/SPEC>`_.

If you want to ask more about the specification, join us on
`#matrix-dev:matrix.org <http://matrix.to/#/#matrix-dev:matrix.org>`_.

If you would like to contribute to the specification or supporting
documentation, see `<CONTRIBUTING.rst>`_.

.. _JSON Schema: http://json-schema.org/