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

Erik Johnston 212a4b5fce Add changelog entry		8 years ago
api	Expand on description of pagination tokens	8 years ago
attic	Consistently spell homeserver as homeserver	9 years ago
changelogs	Add changelog entry	8 years ago
drafts	random incoherent thoughts on reputation that should live somewhere	9 years ago
event-schemas	Fix inconsistencies regarding redacted_because	8 years ago
meta	Link to doc style doc	8 years ago
scripts	swagger-http-server: add a --port argument	8 years ago
specification	Clarify `highlight` and `sound` tweaks.	8 years ago
supporting-docs	Add Drupal Matrix_api module to Try Matrix page	8 years ago
templating	Add a license to the spec	8 years ago
.gitignore	Dump-swagger: take output file name rather than output dir	9 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/