Commit Graph

29 Commits

Author SHA1 Message Date
Will Hunt acf44d7d28
Add m.login.appservice to the spec ()
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Co-authored-by: Hubert Chathi <hubertc@matrix.org>
Co-authored-by: Travis Ralston <travisr@matrix.org>
2021-12-28 16:16:33 -05:00
Richard van der Hoff 5e3ea11050
Replace "Pagination" section in C-S API with text in appendices ()
The Pagination section in the C-S API was, basically, full of rubbish. I think that anything of any value it contained was repeated either directly on the API definitions or in the text specific to syncing at https://spec.matrix.org/unstable/client-server-api/#syncing.

The conventions I've added to the Appendices are based on the discussions in . They are there because I don't want to have to go through it all again next time we add a paginated API.

Fixes: 
Fixes: 
2021-08-27 17:30:30 +01:00
Richard van der Hoff dd0cc92ba8
Start a 'conventions' section in the Appendices ()
I wanted a section for "here's what new APIs ought to do", which isn't really
very useful for consumers of the existing APIs.
2021-08-23 18:07:56 +01:00
Michael[tm] Smith 24810745c2
Drop Origin & Accept from Access-Control-Allow-Headers value
This change drops the Origin and Accept header names from the
recommended value for the CORS Access-Control-Allow-Headers header. Per
the CORS protocol, it’s not necessary or useful to include them.

Per-spec at https://fetch.spec.whatwg.org/#forbidden-header-name, Origin
is a “forbidden header name” set by the browser and that frontend
JavaScript code is never allowed to set.

So the value of Access-Control-Allow-Headers isn’t relevant to Origin or
in general to other headers set by the browser itself — the browser
never ever consults the Access-Control-Allow-Headers value to confirm
that it’s OK for the request to include an Origin header.

And per-spec at https://fetch.spec.whatwg.org/#cors-safelisted-request-header,
Accept is a “CORS-safelisted request-header”, which means that browsers
allow requests to contain the Accept header regardless of whether the
Access-Control-Allow-Headers value contains "Accept".

So it’s unnecessary for the Access-Control-Allow-Headers to explicitly
include Accept. Browsers will not perform a CORS preflight for requests
containing an Accept request header.

Related: Related: https://github.com/matrix-org/synapse/pull/10114

Signed-off-by: Michael[tm] Smith <mike@w3.org>
2021-06-03 14:14:04 +09:00
Travis Ralston 4fc54875b1
Merge pull request from matrix-org/travis/spec/msc2713-rm-v1-id
Remove v1 identity service API
2021-05-04 09:59:27 -06:00
Travis Ralston b4e1a816a9 Remove v1 identity service API
Spec for https://github.com/matrix-org/matrix-doc/pull/2713
2021-05-01 22:47:55 -06:00
Travis Ralston 7458ce9fd1 Downgrade identity server failure to FAIL_PROMPT instead of FAIL_ERROR
Spec for https://github.com/matrix-org/matrix-doc/pull/2284
2021-05-01 22:38:15 -06:00
Travis Ralston 509e056dfa Fix general wording 2021-04-29 22:19:27 -06:00
Travis Ralston c27a29b361 Add knocking to the spec
Spec for https://github.com/matrix-org/matrix-doc/pull/2998
Spec for https://github.com/matrix-org/matrix-doc/pull/2403

This deliberately does not help towards fixing https://github.com/matrix-org/matrix-doc/issues/3153 in order to remain consistent with prior room versions, and to keep the diff smaller on this change. A future change will address room version legibility.
2021-04-28 19:50:13 -06:00
Travis Ralston dec4737f40
Fix event size restriction ()
Fixes https://github.com/matrix-org/matrix-doc/issues/3126
2021-04-16 10:25:30 +01:00
Travis Ralston 745fb766a1
Apply suggestions from code review
Co-authored-by: Matthew Hodgson <matthew@matrix.org>
2021-04-06 09:59:10 -06:00
Travis Ralston 170fd9e3ae Sprinkle some DANGER: UNSAFE warnings over the spec about event bodies
Specs [MSC2801](https://github.com/matrix-org/matrix-doc/pull/2801)
Based on https://github.com/matrix-org/matrix-doc/pull/3094
2021-04-05 20:18:46 -06:00
Will f0a7ba7acf
Fix links to rendered APIs 2021-01-30 13:25:57 -08:00
Will 83f71104f3
Update content to call the new template for event definitions 2021-01-29 20:46:25 -08:00
Will 1a21598c5c
Update content to call the new template for HTTP APIs 2021-01-29 15:32:31 -08:00
Will ea9fced092
Formatting fixes for the authentication section 2021-01-24 11:30:45 -08:00
Will 86152613b1
Remove changelog sections 2021-01-22 14:27:36 -08:00
Will 52745160f3
Use GFM table syntax instead of raw HTML 2021-01-21 17:08:08 -08:00
Will 02a41edc76
Fix heading levels 2021-01-21 09:35:39 -08:00
Will 4e39200cfa
Fix internal links 2021-01-20 21:45:35 -08:00
Will 338434bfcd
Support alerts (notes, warnings, rationales) 2021-01-20 12:34:49 -08:00
Will ab64bda76d
Add syntax highlighting 2021-01-20 10:48:15 -08:00
Will 6c6bd57ebf
Fix ASCII diagrams 2021-01-19 16:41:28 -08:00
Will 55aed1d296
Remove 'unstable' warning 2021-01-19 16:03:15 -08:00
Will 228c737f56
Add support for modules 2021-01-19 15:57:35 -08:00
Will 74adbfc1ec
Remove 'Table of Contents' 2021-01-19 15:32:30 -08:00
Will 9d4803c8af
Remove duplicate titles 2021-01-19 15:30:52 -08:00
Will c924b3246f
Add page content as raw Pandoc output 2021-01-19 15:14:52 -08:00
Will ebc6db233b
Add empty page placeholders 2021-01-19 14:15:46 -08:00