Daniel Wagner-Hall
99106bb6fe
Add explanatory comments
...
Also, remove line which was accidentally removed
9 years ago
Daniel Wagner-Hall
f67e27e843
Split on double-newlines not single
...
Otherwise all sorts of tables get horribly broken
9 years ago
Daniel Wagner-Hall
55f33736b2
Preserve newlines in wrapped text
9 years ago
Kegsay
cf3475515e
Merge pull request #33 from matrix-org/daniel/threepidinvites
...
Spec /room/{roomId}/join
9 years ago
Daniel Wagner-Hall
d399e5b93b
Use an alias object rather than flat fields
9 years ago
Daniel Wagner-Hall
64cfc00f50
Remove unused fluff
9 years ago
Daniel Wagner-Hall
90f5dc370b
Populate aliases from canonical endpoint
...
Swagger validates badly if you have endpoints without the full
specification of things, so instead let's generate them the other way
around.
9 years ago
Daniel Wagner-Hall
d53943c8c2
Spec /room/{roomId}/join
...
This is just replacing the existing spec with a swagger version.
Subsequent pull requests will add 3pid join to this, as well as specing
the invite, leave, ban, and kick endpoints.
9 years ago
Daniel Wagner-Hall
26ebe3e68b
Add ability to refer to aliases of endpoints
9 years ago
Daniel Wagner-Hall
5031c26f7b
Make res optional, and rename to good_response
9 years ago
Daniel Wagner-Hall
0a9f61029a
Allow for missing responses key
9 years ago
Daniel Wagner-Hall
94b13c0121
Show all responses, not just the successful one
...
This still filters out responses lacking either a description or an
example
9 years ago
Kegan Dougal
e572cc662a
Restructure the first few sections.
...
Remove unecessary sections; put presnece/profile sections on the right level.
Move Living Standard warning to the top of the Introduction section.
10 years ago
Kegan Dougal
c42bfabaad
Order the status API before presence lists because it is more important.
10 years ago
Kegan Dougal
e10859a887
Replace presence API with new template.
10 years ago
Kegan Dougal
334e10468d
Add presence swagger and template.
10 years ago
Kegan Dougal
ec631c60d4
Add link to github commit for the spec as per request.
10 years ago
Kegan Dougal
14d004146b
Implement nested tables for HTTP APIs. It even works(!)
10 years ago
Kegan Dougal
0275c2ffa0
Add sync API yaml. Add template for sync_http_api.
10 years ago
Kegan Dougal
bb9537b824
Add a CHANGELOG. Modify table CSS.
...
Hook up templating system to read the CHANGELOG for version and changelog info.
Modified nature.css to make it clearer on table headings/sub-headings. Use the
full _matrix/client path on title links to make it clear it is for v1.
10 years ago
Kegan Dougal
8a676a2b9d
Add sortFn for profile HTTP API. Add combined profile HTTP API.
10 years ago
Kegan Dougal
704cd14030
Add in response format for APIs. Standardise on 'key' rather than 'name'.
10 years ago
Kegan Dougal
f6c98f41e9
Use table subsections for param locations instead of an extra column.
10 years ago
Kegan Dougal
ba6ce16509
Modify how descriptions are shown. Add profile API descriptions.
10 years ago
Kegan Dougal
862f5a3a53
Add structure for adding examples to HTTP APIs.
...
Use 'x-example' to add examples to parameters which are not in 'body' (swagger
doesn't define that currently). Add profile API examples. Add necessary glue
and templates to make it all work.
10 years ago
Kegan Dougal
c75fd6bcae
Add HTTP API wip template.
10 years ago
Kegan Dougal
5795e1ceda
Add profile API examples and extract examples for template usage.
10 years ago
Kegan Dougal
fe7ffafc15
Factor out json schema object processing since swagger uses it too. Hook swagger up.
10 years ago
Kegan Dougal
d090389d01
Start pre-processing swagger APIs before passing to sections.
10 years ago
Kegan Dougal
1dc3d82664
Load swagger APIs as templating units. Check sections return strings.
10 years ago
Kegan Dougal
f134728268
Link to msgtypes from the description of m.room.message.
10 years ago
Kegan Dougal
c3a298a5df
Fix sort order for VoIP events.
10 years ago
Kegan Dougal
ac7ccfa622
Add {{presence_events}}. Factor out common code in MatrixSections.
10 years ago
Kegan Dougal
9abadaf7af
Add {{presence_events}} template.
10 years ago
Kegan Dougal
e046402a4a
Shift msgtype section order to have common (implemented) types first.
10 years ago
Kegan Dougal
6f330bd879
Gut the old msgtypes section and replace with {{msgtype_events}}
10 years ago
Kegan Dougal
59f856c7e6
Factor out ImageInfo into a core type. Refer to that in other msgtypes.
...
Add templating for msgtypes. ImageInfo core type is not referred to for
m.image in order for the ImageInfo table to render for it.
10 years ago
Kegan Dougal
06177740d4
Tweak how constants are represented.
10 years ago
Kegan Dougal
9d532f30e8
Add {{voip_events}}. Add more info on sections when asked via build.py -s
10 years ago
Kegsay
2a02b3494f
Minor tweaks
10 years ago
Kegan Dougal
89083b3a86
Add {{spec_version}}. Update build.py module docs.
10 years ago
Kegsay
c721bb7e61
Update template readme
10 years ago
Kegan Dougal
5b31c442f5
Completely split up the templating system from the Matrix Spec template code.
...
The two are now linked together in build.py by specifying the input module.
Updated gendoc.py to specify the right module.
10 years ago
Kegan Dougal
8e1d6899c2
Start encapsulating Units too. Add debug option which controls logging.
10 years ago
Kegan Dougal
96671ce833
Use the templating system to set {{git_version}}. Restructure sections code.
...
Restructured the sections code to be slightly more encapsulated than before.
This will be expanded to more clearly separate the templating system from
the specific implementation of the spec templates.
10 years ago
Kegan Dougal
d3dca1f357
Sort keys alphabetically in tables. Sort event types alphabetically in sections.
10 years ago
Kegan Dougal
dc5c01607b
Sort out table layout and rejig where state_key is placed.
10 years ago
Kegan Dougal
ed4ce6950c
Template up common event fields from the 'core' json schema file.
10 years ago
Kegan Dougal
6dcbc40b63
Add common event field descriptions and template.
10 years ago
Kegan Dougal
54783a59c3
Put state_key info on same line as State Event text.
10 years ago