Daniel Wagner-Hall
1d2ed9e9d6
Changelogs: indent instead of blockquoting
9 years ago
Daniel Wagner-Hall
dcd51c39b3
Indent state-key descriptions
...
Right now two spaces make a <dt> whereas four does the right thing.
9 years ago
Daniel Wagner-Hall
b8ea5f7ffb
Resolve references by default
...
This means I can re-use this function for the swagger-UI generation
I can't see why you would want un-resolved references as a consumer.
9 years ago
Daniel Wagner-Hall
39f43abbb7
Add per-API changelogs
9 years ago
Daniel Wagner-Hall
f81b967e2d
Make all the schema files yaml
9 years ago
Daniel Wagner-Hall
614ee9ea1b
Move application service swagger out of c-s dir
9 years ago
Daniel Wagner-Hall
97fd1fdd62
Embed client and server release numbers
...
Note that this also removes the changelog - I'm going to re-add the
changelog differently soon.
9 years ago
Daniel Wagner-Hall
6c66bfc755
Flatten out v1 and v2_alpha directories
...
As a side effect, I got rid of all of the horrible symlinks and just put
in all of the proper relative paths. Because the horrible symlinks were
horrible.
9 years ago
Richard van der Hoff
9fb26f7c85
Merge pull request #163 from matrix-org/rav/rework_objects
...
Updates to swagger table generation
9 years ago
Daniel Wagner-Hall
4faede73a1
Merge branch 'master' into daniel/multipleexamples
9 years ago
Richard van der Hoff
34ac544290
Merge branch 'master' into rav/rework_objects
...
Conflicts:
templating/matrix_templates/units.py
9 years ago
Kegan Dougal
d1c685f296
Merge branch 'master' into rav/refactor_tables
9 years ago
Kegan Dougal
8648f86032
Moar spaces
9 years ago
Erik Johnston
96be7ff241
Support more nesting
9 years ago
Richard van der Hoff
838af2a23e
Updates to swagger table generation
...
A bunch of related fixes to the code for parsing the state and API yaml files:
1. Some of our objects are {key: {key: value}} - style nested key/value
dictionaries. Handle this by refactoring get_json_schema_object_fields so
that such objects are handled wherever they appear, rather than when they
are just subproperties of a 'proper' object.
2. Fix multi-level inheritance (so an object can have an 'allOf' property which
can successfully refer to an object which itself has an 'allOf' property).
3. $ref fields in event schemas weren't being expanded correctly
4. sort type tables breadth-first rather than depth-first so that the ordering
in complex structures like the /sync response makes a bit more sense.
9 years ago
Richard van der Hoff
cc8ef691fb
Rewrite the table templates
...
Allow columns to stretch if they end up with wide content.
Apart from the hassle of having to manually update the calculations, having the
columns wide enough to hold the widest thing they might ever have leads to
tables with lots of whitespace in the results.
9 years ago
Daniel Wagner-Hall
d7357ef9b7
Specify /publicRooms
9 years ago
Daniel Wagner-Hall
c00abe9f2f
Fix msgtype display
9 years ago
Daniel Wagner-Hall
071edcd86e
Merge branch 'master' into daniel/multipleexamples
9 years ago
Daniel Wagner-Hall
e72151f2c3
Specify guest room access
...
This was reviewed as PR #150 and merged from daniel/anonymousaccess
9 years ago
Daniel Wagner-Hall
2734f9f9f2
Merge branch 'master' into daniel/multipleexamples
...
Conflicts:
specification/modules/third_party_invites.rst
9 years ago
Daniel Wagner-Hall
232b10b0f6
Merge branch 'master' of github.com:matrix-org/matrix-doc
9 years ago
Mark Haines
b7cc5b1018
Merge pull request #141 from matrix-org/markjh/full_http_api_docs
...
Include the full schema for an http API in the docs
9 years ago
Mark Haines
c719946370
Enable syntax highlighting for message type examples
9 years ago
Mark Haines
8070489080
Handle lists of types in arrays
9 years ago
Mark Haines
e49ea9015f
Deduplicate tables with the same title
9 years ago
Mark Haines
8322151661
Don't put a space when appending the "Must be" strings to the desciption if there isn't a description, otherwise it will mess up the indent
9 years ago
Daniel Wagner-Hall
2e3a0b4e00
Specify guest accounts
9 years ago
Mark Haines
91eb25b76d
Include the full schema for an http API in the docs by resolving references to other files
9 years ago
Daniel Wagner-Hall
176f919fc8
Show multiple examples where present
9 years ago
Mark Haines
71874870c8
Enable syntax highlighting for example http requests
9 years ago
Mark Haines
3f1cbb22bb
Enable syntax highlighting for the JSON event examples
9 years ago
Kegan Dougal
30d46a19d5
Review comments
9 years ago
Kegan Dougal
3b7585cbda
Make nested request objects display correctly (search API)
...
This now displays search_categories.room_events.filter and co correctly.
Also make arrays of enums display correctly.
9 years ago
Kegan Dougal
f95d19cecd
Merge branch 'master' into appservice-swagger
...
Conflicts:
specification/application_service_api.rst
9 years ago
Kegan Dougal
bbd3f8072c
Review comments
9 years ago
Kegan Dougal
d39a9082a0
Add invite_room_state to spec. Flesh out info.
9 years ago
Kegan Dougal
f20faa80e5
Swagger validation
9 years ago
Daniel Wagner-Hall
2502ca7ac6
Merge branch 'master' into daniel/threepidinvites-2
...
Conflicts:
specification/targets.yaml
9 years ago
Kegan Dougal
213cb25290
Wrap correctly
9 years ago
Kegan Dougal
f2a6950cc3
Minor tweaks; allow objects without props/parents if a title is set
...
This allows us to do things like {Tweaks} where Tweaks is defined somewhere
else.
9 years ago
Daniel Wagner-Hall
21a40b317d
Merge branch 'master' into daniel/threepidinvites-2
9 years ago
Kegan Dougal
65504db7bb
Display nested keys on arrays of objects. Make it valid swagger.
9 years ago
Kegan Dougal
31ae4b3859
Swaggerify push notification API
...
Edit units.py to support nested JSON request keys
9 years ago
Kegan Dougal
a9618a981b
Swaggerify the /enabled endpoint
9 years ago
Kegan Dougal
56ce432399
Get profile tag keys displaying correctly.
9 years ago
Kegan Dougal
c5edc60c4c
Add push YAML for pushers endpoint.
...
Also display "required" text on required JSON body request params. Also
increase the size of the request param column to support longer param names
present in the pushers API.
9 years ago
Kegan Dougal
09ac367847
Merge branch 'master' into module-content-repo
...
Conflicts:
templating/matrix_templates/units.py
9 years ago
Kegan Dougal
4dabcd112e
Remove redundant info now we have the http api template. Minor tweaks to display of schema with no names but a type
9 years ago
Daniel Wagner-Hall
d2c56fb7a3
Merge branch 'master' into daniel/threepidinvites-2
9 years ago