Commit Graph

6992 Commits (715e66fa00a6fa4e90ef1d55185fe9648527bdda)
 

Author SHA1 Message Date
Andrew Morgan 715e66fa00 Improve styling of the endpoints list
- Add a hover effect over endpoints
- Make the method bold to differentiate it from the endpoint itself
- Make cs module titles larger
1 month ago
Andrew Morgan f30e850bf1 Fix duplicate modules endpoints
I was seeing duplicate endpoints appearing under each module (typically
2 of each). This turned out to be due to the `render-operation` partial
being called multiple times (once when rendering the page, and another
when rendering the left-hand-side TOC).

We now check whether the endpoint has already been added to the list
before insertion, via a "seen" map (for quick lookup).
1 month ago
Andrew Morgan 468fcb3992 Group endpoints by module
Makes the list of endpoints easier to scan.
2 months ago
Andrew Morgan 2d0e4ea471 Source endpoints from CS API modules as well
Any endpoint in a CS API module was not getting listed. This is because they are stored in nested pages. We need to hoist them up to the outer page, such that they can be retrieved and rendered by our endpoints TOC partial.
2 months ago
Andrew Morgan 42a1bc370f newsfile 2 months ago
Andrew Morgan 17acd978a4 Display "(deprecated)" next to deprecated endpoints 2 months ago
Andrew Morgan 1213f81676 Move each spec's intro above the endpoints list
This just looks visually nicer. You have an introduction paragraph, then
the list of endpoints, then the spec.
2 months ago
Andrew Morgan f03730455d Place the endpoints list just under the description of each API
We needed to override Docsy's default page renderers to show it. Because
the Client-Server API uses a different render chain than the other
endpoint pages, we have to override two of Docsy's pages (`content.html` and `single.html`).

In order to reduce duplication, we then put the shared content into a
`spec-content.html` partial.
2 months ago
Andrew Morgan 56d48eb3a8 Add an endpoints table of contents
A simple list of endpoints that one can ctrl-f through.
2 months ago
Andrew Morgan 82a67a1fab Store each endpoint's metadata in a slice on Page
Such that we can later construct the table of contents with the data.
2 months ago
Johannes Marbach 7a1eb81c9c
Fix versions.json URL in unstable and local environment (#2259) 2 months ago
Johannes Marbach 22c0952003
Load versions.json as a resource if we're in the unstable spec (#2258)
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
2 months ago
Johannes Marbach a5afe542c0
Add version picker in the navbar (#2256)
Co-authored-by: Andrew Morgan <andrew@amorgan.xyz>
2 months ago
Johannes Marbach d28e05af87
Clarify that usage of event_id_only is not mandatory (#2255)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2 months ago
reivilibre b1fd2af72c
Clarify that servers may choose not to use `M_USER_DEACTIVATED` when they don't know who is asking. (#2246)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2 months ago
Forest f7a0d8d135
secrets.md: trivial grammar fix (#2250)
Co-authored-by: Andrew Morgan <andrew@amorgan.xyz>
2 months ago
Johannes Marbach a2027a3985
Spec for MSC4312: Resetting cross-signing keys in the OAuth world (#2234)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2 months ago
Hugh Nimmo-Smith ff1a39e36a
List M_RESOURCE_LIMIT_EXCEEDED under correct error code section (#2232)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2 months ago
Doug add0f2232c
Call out the possibility of redacting events that you don't have the power to send. (#2249) 2 months ago
Johannes Marbach 8ebf4a4789
Clarify that device_one_time_keys_count is only optional if no unclaimed one-time keys exist (#2245)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
2 months ago
Johannes Marbach 935c23485b
Clarify how to use state_after ahead of declaring full support for its spec version (#2240) 2 months ago
Johannes Marbach fe3f43a905
Point Olm and Megolm links at the new internal specification (#2242)
Relates to: #1543
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
3 months ago
Richard van der Hoff 4783619964
Fix broken link to katex CSS (#2241)
Followup to https://github.com/matrix-org/matrix-spec/pull/2226, which broke
the build. These links to the static CSS are broken in the case that the spec
is built for a subdirectory (such as `unstable`).
3 months ago
Johannes Marbach 4cafe7d9f4
Include Olm & Megolm specifications in main spec (#2226)
Fixes: #1543
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
3 months ago
Michael Telatynski e2b2e56bd2
Use NPM Trusted Publishers over token (#2239)
* Use NPM Trusted Publishers over token

due to security changes being enacted next month by npm

* Add changelog entry

* Update npm
3 months ago
Johannes Marbach 967b54195c
Clarify the special casing of membership events and redactions in power levels (#2231) 3 months ago
Johannes Marbach 9d063c8d2d
Add m.login.terms to enumeration of authentication types (#2233)
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
3 months ago
Kévin Commaille 74a0d5f289
Silence redocly-cli rule checking examples (#2238)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
3 months ago
Tol Wassman 974b0b721e
fix typo (#2227)
* fix typo

* create newsfragment

This seems to be the standard message for typo fixes.
3 months ago
Hugh Nimmo-Smith fda3be5ee3
Add note where an endpoint uses capability negotiation (#2223) 3 months ago
Travis Ralston 7f4072d993
Spec device ID masquerading (#2221) 3 months ago
Sarthak Kumar Shailendra 58744f4734
fix: update twitter icon to x (#2219) 4 months ago
Johannes Marbach dfdb1d09b8
Add missing bracket (#2224) 4 months ago
Johannes Marbach f82d8ab15b
Clarify that additional OpenGraph properties can be present in URL previews (#2225)
Fixes: #1753

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
4 months ago
Travis Ralston b6a127b5cb
Clarify that restricted joins require the referenced user to be joined (#2220) 4 months ago
Johannes Marbach 0a649cb0db
room_id is required for peeking (#2216) 4 months ago
Johannes Marbach d8be2ad942
The `server-name` segment of MXC URIs is sanitised differently from the `media-id` segment (#2217)
Fixes: #1990

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
4 months ago
Johannes Marbach 21109b4d5b
Push rule IDs are globally unique within their kind (#2214) 4 months ago
Johannes Marbach d4d31a8894
Don't advertise creator field in description of room creation (#2215) 4 months ago
Christian Paul d968774fb7
Missing quotation marks: Fix JSON formatting in application-service-api.md (#2213) 4 months ago
Kévin Commaille 2aacc1feda
Remove legacy mentions (#2186)
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
4 months ago
Travis Ralston 2a8c0bc7b8 Return to unstable 4 months ago
Travis Ralston 81a864545f Matrix 1.16 4 months ago
Travis Ralston 671bc674cd Changelog normalization 4 months ago
Johannes Marbach 72a2ebc7ad
Spec PR - MSC4142: Remove unintentional intentional mentions in replies (#2210) 4 months ago
Travis Ralston 7bc016bda6
Specification for MSC4311: Create event availability in stripped state (#2207)
* Part 1: Invites

* Part 2: Knocks

* Use correct schema and examples; Remind readers often about formats

* changelogs

* Add schema warning

* Name the objects

* Move changed-in and expand upon it

* Rename the example

* address review feedback
4 months ago
Patrick Cloke fea0b925a0
Add time zone profile field from MSC4175 (#2206) 4 months ago
Kim Brose bfbeb5e257
clarify world_readable history visibility (#2204)
Signed-off-by: HarHarLinks <2803622+HarHarLinks@users.noreply.github.com>
4 months ago
Kim Brose d1a51f7b8c
fix typo in MSC process (#2205)
Co-authored-by: Andrew Morgan <andrew@amorgan.xyz>
4 months ago
V02460 6e16a19ac9
[schema] Application Service Registration meta schema (#2132) 5 months ago