The Matrix protocol 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
Richard van der Hoff a8eb72e7a1 Fix changelog generation
Gendoc was adding extra newlines to the changelog RST, which messed it all up.
8 years ago
api Fix the swagger for /search so that it works without preprocessing 8 years ago
attic Consistently spell homeserver as homeserver 9 years ago
changelogs Clarify `history_visibility` behaviour 8 years ago
drafts random incoherent thoughts on reputation that should live somewhere 9 years ago
event-schemas Add event as a parent for all event types 8 years ago
meta Update doc style 9 years ago
scripts Update README.md 8 years ago
specification Clarify which documents are generated from scripts. 8 years ago
supporting-docs Remove port number from room IDs in pasted examples 8 years ago
templating Fix changelog generation 8 years ago
.gitignore Dump-swagger: take output file name rather than output dir 8 years ago
CONTRIBUTING.rst Add CONTINUTING.rst 8 years ago
README.rst alas clarify the room link 9 years ago
jenkins.sh Remove redundant node event schema checker 9 years ago

README.rst

This repository contains the documentation for Matrix.

Structure
=========

- ``api`` : Contains the HTTP API specification.
- ``drafts`` : Contains documents which will make it into the specification
  and/or supporting documentation at some point in the future.
- ``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, or have suggestions for
improvements, join us on ``#matrix-dev:matrix.org`` via https://matrix.org/beta.

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