matrix-spec

Commit Graph

Author	SHA1	Message	Date
Kévin Commaille	5fbfdd6821	Fix generated HTML (#1880 ) * Add tr as child of thead in HTML tables It is invalid HTML for th to be the direct children of thead Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Remove unnecessary HTML code end tag Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Avoid nesting p HTML elements A p HTML element cannot contain other block elements, so the "parent" element is closed when the first "child" one is opened. We need to use Page.RenderString with options to force Hugo to keep the wrapping p elements even if the content contains a single paragraph. Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Add missing HTML details end tags Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Replace HTML a self-closing tag with start and end tags The a element start and end tags are mandatory. Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Replace obsolete HTML name attribute with id Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr> * Add changelog Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>	5 months ago
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>	9 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

12 Commits (97601f12ff268d4471ac46be9321318b8e4177c8)