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

Kegan Dougal f71763b0d3 Implement relative title styles Templates don't know at what level they will be inserted. Previously, we hard-coded the title style which is not compatible with the build target system. Define a set of styles which will be replaced by the gendoc script when it encounters them: '<' : Make this title a sub-heading '/' : Make this title a heading at the same level '>' : Make this title a super-heading The build target system is now basically complete and functioning.		9 years ago
api	Make to code to skip checking swagger responses which don't have an	9 years ago
attic	Add v1 registration / login stuff into attic dir	9 years ago
drafts	Reshuffle spec into sections roughly right as per PR #52	9 years ago
event-schemas	Skip files that start with ".", e.g. vim swp files.	9 years ago
meta	Update doc style	10 years ago
scripts	Implement relative title styles	9 years ago
specification	Implement relative title styles	9 years ago
supporting-docs	glue footer to the bottom	9 years ago
templating	Implement relative title styles	9 years ago
.gitignore	.gitignore speculator	9 years ago
CHANGELOG.rst	Add sync API yaml. Add template for sync_http_api.	9 years ago
README.rst	alas clarify the room link	9 years ago
jenkins.sh	Add the jenkins command to source control so that we can update	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/