matrix-spec

Commit Graph

Author	SHA1	Message	Date
Kévin Commaille	a0bc6e7f83	Add anchors in `definition` shortcode (#1802 ) Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>	7 months ago
Kévin Commaille	4d7e33ec26	Add support for `$ref` URIs containing fragments in OpenAPI definitions and JSON schemas (#1751 ) Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>	8 months ago
Kévin Commaille	e40d9ca186	Fix rendering of `m.receipt` event in Client-Server API (#1637 ) ... and other improvements Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>	1 year ago
David Robertson	48459dee9b	Only include titles in summaries (#1549 ) I previously made this change for HTTP endpoints in #1446. It seems there are other places where we have over-sized `<summary>` elements. I would like to elimintate those too, as grumbled about in https://github.com/matrix-org/matrix-spec/issues/1358#issuecomment-1325220859 and https://github.com/matrix-org/matrix-spec/issues/1352#issuecomment-1439033334	2 years ago
Richard van der Hoff	1e393fbf92	Improve error messages emitted by `resolve-additional-types` (#1303 ) I forgot to set the `items` on an array definition, and got an extremely opaque error. Hopefully this will improve the lives of anyone who makes a similar mistake in future.	2 years ago
Richard van der Hoff	bc15d4f9bc	Make definition anchors more unique (#1339 ) Stick a `definition-` on the front of the autogenerated anchors for definition blocks. This solves a problem where, for example, https://spec.matrix.org/unstable/application-service-api/#registration could refer to either the "Registration" section or the `Registration` definition therein. (These anchors are relatively recent: they were added in #1191.	2 years ago
Richard van der Hoff	dc4fd9bdd6	Render HTML anchors for definition blocks (#1191 ) It's handy to be able to link to these.	2 years ago
Richard van der Hoff	ea42cd3c7b	Move various e2e defintions out to yaml files (#1166 ) We have code to generate tables, which we should use in the e2e section.	2 years ago
Richard van der Hoff	5f3b34448d	Add HTML ids for object definitions in the formatted specification (#1174 ) * Remove redundant call to resolve-allof All of the callers to resolve-additional-types already call resolve-allof (or if not, they should), so this is redundant. * Update `resolve-additional-types` to take a dict I want to add more params to this, so first make it take a dict. * `render-object-table`: take a "title" rather than a "caption" ... which means we can use the result from resolve-additional-types directly. * render-object-table: support adding an anchor to generated tables. * resolve-additional-types: generate an id for each returned type * render-event: pass an anchor_base into resolve-additional-types This means that it will generate an anchor for each type, whihc will then be passed into render-object-table and used as an `id` for the table. * render-operation: pass an anchor_base into resolve-additional-types * newsfiles	2 years ago
Travis Ralston	5be0df02c5	Start annotating which version of the spec added a thing (#3425 ) * Introduce a new "added-in" template and use it on endpoints * Use "added-in" on schema properties too * Annotate sections of the spec with their added versions * Demo of "added-in" on a room version (to be fleshed out) * Use clearer versioning semantics * Update and fix validator for Swagger custom properties * Fix docs	3 years ago
Will	5f45a897ef	Add templates used to render data	3 years ago

11 Commits (1fc25d8d48514b1fc2df0c3e4b015a3746802c22)