5b12e2cfef
Convert event schemas to yaml
...
We've decided to make the event schemas YAML, so we might as well take
advantage of it.
(This conversion was done mostly automatically, except for:
- s/null/"null"/ in m.room.member
- reformat description in m.room.power_levels
8 years ago
253b3a76df
no longer lacking in features!
8 years ago
ec69f04793
Merge pull request #337 from matrix-org/rav/directory_docs
...
Improve documentation of directory API
8 years ago
7bbb664784
Improve documentation of directory API
8 years ago
2daf5e7c72
Merge pull request #336 from sbts/patch-1
...
Update Spec with info about recommended power name to number mapping
8 years ago
92bb1c1b43
Update wording as per request from richvdh
8 years ago
6aeb9f4595
Merge pull request #335 from nott/nott/add-pyyaml-to-scripts-readme
...
Add PyYAML to scripts/README.md
8 years ago
a7e40bed88
Add powerlevel name to value list
8 years ago
b6c41727c5
Add PyYAML to scripts/README.md
...
PyYAML is a 3rd-party package used by `gendoc.py`.
8 years ago
666229073e
fix 3pid mapping wording
8 years ago
689177e2fc
adding goMatrix
8 years ago
d4d2191d47
update links
8 years ago
a90e65d4e5
Feature Vector mobile clients on Try Matrix Now page
8 years ago
099d356dfb
Add r0.1.0 to version list in C-S spec
8 years ago
2eebacacfe
Merge pull request #286 from matrix-org/dbkr/default_state_defaults
...
Update spec to say what the default state / events defaults are
8 years ago
33ec8dde88
m.room.power_levels: More newlines
8 years ago
8c3838bc04
Formatting tweaks for m.room.power_levels
8 years ago
8b61dab1c6
gendoc.py: add --list_targets arg
...
I want to be able to run all of the targets except one from matrix-doc, so make
a way to list the targets.
8 years ago
69c2eb7edb
Merge pull request #333 from matrix-org/rav/back_to_r0.1.0
...
Next release will be 0.1.0, not 1.0.0
8 years ago
590c55b760
Next release will be 0.1.0, not 1.0.0
...
Since synapse is already doing the new behavior on r0 endpoints, and nobody
wants to support the old behaviour, we're defining the new behaviour as r0.1.
8 years ago
8f4d7c95df
Include '..' lines in changelogs
...
Not all lines starting with '..' are comments, and even if they are comments,
they might as well go into the generated spec ReST.
8 years ago
86a81b0450
Fix schema for /logout
...
'properties' is a map, not a list
8 years ago
e7e9f5fa46
Document the /logout api
...
We have one, and it's useful, so we really ought to document it
8 years ago
2e446594a1
Merge pull request #328 from matrix-org/rav/auth_api_docs
...
Tidy up the client-authentication spec
8 years ago
d52377274f
adding vector mobile clients
8 years ago
3bce28a15c
Clarifications to the 'Client authentication' section
...
* Use the terminology 'login type' everywhere instead of mixing up 'stage type'
and 'login type'
* Don't have a separate 'APIs using the User-Interactive Authentication
mechanism' section, because (a) it doesn't make much sense to organise the
APIs this way, and (b) it was a set of lies anyway.
* Move '/account/password' definition into registration.yaml so that register
and password can share a section in the spec; remove duplicate doc for
/password.
* Write some words on using 3pids for /login
8 years ago
2093a6bac9
Merge pull request #332 from matrix-org/rav/update_login_api
...
Update the /login API spec
8 years ago
2cbebbe506
Merge pull request #331 from matrix-org/rav/doc_interactive_api_params
...
Document the user-interactive api params
8 years ago
959f1ff09f
Update the /login API spec
...
Note that /login can be used with 3pid creds
8 years ago
9efd021f5e
Document the user-interactive api params
...
Document the parameters and responses on /register and /account/password which
are invoved in the user-interactive auth
8 years ago
0cdc2da5bf
Merge pull request #330 from matrix-org/rav/improve_examples
...
Improve API examples in the spec
8 years ago
167b84cc7f
Another go at formatting examples
...
Let's try to avoid parsing the JSON, as it will reorder the examples.
8 years ago
45199d0edc
Attempt to parse examples as json
...
... because some of them are, and we don't want to double-escape them.
8 years ago
6b23598a26
Improve API examples in the spec
...
* Show response codes even if we don't have examples for them
* Walk the objects to build param examples if none are given at the top level
8 years ago
2d28e5abce
Fix basePath on /redact API doc
8 years ago
d1fd9de10e
Merge pull request #329 from matrix-org/rav/basepath_in_swagger
...
Include the basePath in the path in swagger output
8 years ago
f46a2a7f2b
Include the basePath in the path in swagger output
...
This fixes both SPEC-393, and ORG-52.
8 years ago
85ad53ae70
encourage contributions!
8 years ago
771b21a316
add new guides to guide page
8 years ago
b0284f0c7e
Merge pull request #327 from matrix-org/rav/no_sort_api
...
Don't sort the HTTP APIs
8 years ago
695a533e45
Don't sort the HTTP APIs
...
We can order them manually in the YAML, so why would we want a completely
different order in the spec?
8 years ago
5cc9066159
Add git versions to other parts of the spec
8 years ago
0e4a4e1e44
Merge pull request #326 from matrix-org/rav/more_spec_versioning
...
Put each bit of spec in its own directory
8 years ago
8aa0f64665
Update the speculator to understand spec subdirs
...
Fix the speculator so that it doesn't blow up when it finds subdirs in the gen
directory.
(It doesn't handle the html diff very well in the case that the subdirs don't
match, but it's hard to do much about that)
8 years ago
01f8173c84
Put each bit of spec in its own directory
...
I want to change the URLs for the spec sections on the website from
<version>/<section>.html to <section>/<version>.html, to better reflect how we
do the versioning.
This puts each bit of spec in its own directory, updates the index to point to
the right place, and fixes continuserv to deal with directories as well as
files.
This will probably require fixes to the speculator too, but I'll have to come
back to that.
8 years ago
1f53be4d59
Merge pull request #325 from matrix-org/oddvar/new-guides
...
add these to jekyll
8 years ago
cde9134467
add these to jekyll
8 years ago
a8eed29e9f
gendoc: Allow multiple targets
8 years ago
a482cda8a8
Merge pull request #324 from matrix-org/rav/spec_versioning
...
Move the 'old versions' links into the client-server API spec
8 years ago
8f304f3b3e
C-S API will be released as r1.0.0, not r0.1.0
8 years ago
Richard van der Hoff