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.