11c586c560
Merge branch 'master' into spec-feature-profiles
...
Conflicts:
templating/build.py
9 years ago
e5f805c0d5
Merge pull request #67 from matrix-org/unused-template-vars
...
Detect unused {{ vars }} and whine loudly.
9 years ago
4d407c2731
Merge pull request #66 from matrix-org/speculator-htmldiff
...
speculator: Add HTML diffing
9 years ago
9c882ea5e4
Detect unused {{ vars }} and whine loudly.
9 years ago
2434dfaf1c
Merge branch 'master' into speculator-htmldiff
9 years ago
510553ee00
Remove smurf suffixes. Add anchor for feature profiles.
9 years ago
9fac152d32
Explain what the clients are and the column reference
9 years ago
c6375ed3d1
Flesh out feature profiles section
...
Add table detailing the profiles. Add anchors to link through to each module
following a well-defined format (rather than the name of the module section).
Allow UTF-8 in the spec.
9 years ago
cd6f15f627
Remove obsolete comment
9 years ago
0c1eb50ef4
Merge pull request #26 from matrix-org/macaroons
...
Spec macaroons and token refresh
9 years ago
f5d436bd80
Remove extraneous )
9 years ago
6c1491b3ba
Respond to some review comments
9 years ago
5c4398c181
Remove superfluous comma
9 years ago
fc87f4cdb0
Remove unused keys
9 years ago
6c89e6ea67
Wrap refresh_token in `s
9 years ago
15308ab435
Merge pull request #62 from matrix-org/markjh/check_request_schema
...
Check the request example JSON matches the schema
9 years ago
f34722485f
Check the request example JSON matches the schema
9 years ago
ca9f30a7fd
Merge pull request #61 from matrix-org/markjh/node_swagger_validator
...
Only validate a file if it ends with ".yaml".
9 years ago
385b6c4759
Only validate a file if it ends with ".yaml".
...
Otherwise we try to validate vim .swp files.
9 years ago
0346568519
Merge pull request #60 from matrix-org/gendoc-logging
...
Gendoc logging
9 years ago
6afdfc0771
Add more logging and make logging context clearer
...
This is now actually useful if you want to debug why your swagger YAML
isn't producing a table you think it should be.
9 years ago
f1adad5fb3
Add more logging with file prefixes
...
This makes the handoff between gendoc and batesian clearer in the logs.
9 years ago
064a2c9172
Use argparse and log functions for gendoc.py
...
gendoc.py has become more complex such that we actually want to pass things
to it like `--verbose`, `--nodelete`, `--target`, so use `argparse` to do this
like we have `build.py`. Pass through `-v` flags to `build.py`.
9 years ago
14e77b09ab
Merge pull request #59 from matrix-org/spec-restructure-modules
...
Add spec build targets; restructure spec
9 years ago
1da64db302
Use relative depths for groups instead of absolute ones
...
This means the group can be agnostic to how deeply nested it is,
improving reusability of groups.
9 years ago
29bae15790
Fix typo
9 years ago
5115346297
Add instant_messaging module; modify batesian section rules
...
Previously, all `m.room.*` events were wodged into `{{room_events}}` which
isn't great when you want to pull specific ones out. Batesian had a 1:1
mapping of `render_foo()` to a section `{{foo}}`, and having to constantly
add functions for new types is a PITA. Batesian now supports returning a
`dict` instead of a section `string` where the keys are the `{{foo}}` and
the value is what will be inserted. Also add conflicting section key checks
to avoid multiple definitions of the same `{{foo}}`. Define dicts for
event schemata and swagger HTTP APIs.
Using this new feature, split out the instant messaging stuff from the events
section, and replace `{{room_events}}` with a list of specific events e.g.
`{{m_room_member_event}}`.
9 years ago
5b134119bd
Add presence module; fix relative title bug
...
If a relative title appeared after an HTTP API table, it
would insert the wrong level because it thought that part
of the table was a title.
9 years ago
b49cb57fe5
Move events sections to CS API
9 years ago
16693a644a
Various review fixes
9 years ago
b21859836d
Print stdout of build.py in verbose mode
9 years ago
388aeefac0
Remove obsolete key
9 years ago
b0eb985523
Merge branch 'master' into spec-restructure-modules
9 years ago
895ffcfcde
Merge pull request #56 from matrix-org/markjh/document_v1_rooms_api
...
Document the getters for the /rooms/{roomId} APIs
9 years ago
056b5eba22
Partially handle representing top-level array responses
...
If an HTTP API returned a top-level array response, the templating system
would fail to create a table for it. This is now partially fixed by pulling
out the type of the elements (no recursion is done to populate nested tables)
9 years ago
0c0ac3e814
Fix common event fields template to use subtitle char
9 years ago
e8cdfcbba2
Rename spec files to not have numbers everywhere; update targets.yaml
9 years ago
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
98d91d0c2b
Make the example room id more "random" so that people are less likely to think that it is supposed to be human readable
9 years ago
f60190086a
Describe the behaviour of /rooms/{roomId}/member when the user has left the room
9 years ago
067363c629
Get the desired title levels right; print out the actual level used to stdout
9 years ago
ba6c7d267c
SPEC-216: Document the behaviour of the room getters when the user has left the room
9 years ago
615a9575cb
SPEC-216: Clarify when the room getters will return 403
9 years ago
cb41adee70
Fix the swagger host to be "localhost:8008" so that it can be used in a "Try it now" setup against localhost
9 years ago
d5e0115e42
Merge branch 'master' into spec-restructure-modules
9 years ago
65ce95249f
cat the spec according to the build target. Remove old checks as they are now obsolete since we don't care about the filename
9 years ago
2efadea583
Merge branch 'master' into markjh/document_v1_rooms_api
9 years ago
8590cc84b5
Process and extract targets in gendoc.py
9 years ago
83ee385543
Merge pull request #55 from matrix-org/markjh/codehighlighting
...
Turn on code highlighting for HTTP api responses
9 years ago
a64125772f
Merge pull request #58 from matrix-org/markjh/jenkins
...
Add the jenkins command to git so that we can update it
9 years ago
Kegan Dougal