This repository contains the documentation for Matrix.

• 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.

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.

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