Merge 57c6273162 into 0b5db68242

clarification: Correct wording in appservice docs (#2330 )
Update 2329.clarification
2026-04-09 12:54:10 +02:00 · 2026-03-06 20:37:09 +01:00 · 2026-03-06 19:21:02 +02:00 · 2026-03-04 08:24:32 -08:00 · 2026-03-04 08:22:29 -08:00 · 2026-03-04 08:13:13 -08:00
4 changed files with 9 additions and 7 deletions
--- a/changelogs/application_service/newsfragments/2330.clarification
+++ b/changelogs/application_service/newsfragments/2330.clarification
@ -0,0 +1 @@
+Fix various typos throughout the specification.
--- a/changelogs/client_server/newsfragments/2329.clarification
+++ b/changelogs/client_server/newsfragments/2329.clarification
@ -0,0 +1 @@
+Add link to JSON signing algorithm in server-server auth section for clarity. Contributed by @thetayloredman.
--- a/content/application-service-api.md
+++ b/content/application-service-api.md
@ -84,7 +84,7 @@ For the `users` namespace, application services can only register interest in
 homeserver). Events affecting users on other homeservers are not sent to an application
 service, even if the user happens to match the one of the `users` namespaces (unless,
 of course, the event affects a room that the application service is interested in
-for another room - for example, because there is another user in the room that the
+for another reason - for example, because there is another user in the room that the
 application service is interested in).

 For the `rooms` and `aliases` namespaces, all events in a matching room will be
--- a/content/server-server-api.md
+++ b/content/server-server-api.md
@ -277,12 +277,12 @@ queried from multiple servers to mitigate against DNS spoofing.

 Every HTTP request made by a homeserver is authenticated using public
 key digital signatures. The request method, target and body are signed
-by wrapping them in a JSON object and signing it using the JSON signing
-algorithm. The resulting signatures are added as an Authorization header
-with an auth scheme of `X-Matrix`. Note that the target field should
-include the full path starting with `/_matrix/...`, including the `?`
-and any query parameters if present, but should not include the leading
-`https:`, nor the destination server's hostname.
+by wrapping them in a JSON object and signing it using the [JSON signing
+algorithm](/appendices#signing-json). The resulting signatures are added
+as an Authorization header with an auth scheme of `X-Matrix`. Note that
+the target field should include the full path starting with `/_matrix/...`,
+including the `?` and any query parameters if present, but should not
+include the leading `https:`, nor the destination server's hostname.

 Step 1 sign JSON:
Author	SHA1	Message	Date
Logan Devine	7944d9dbe3	Merge `57c6273162` into `0b5db68242`	2026-03-06 20:37:09 +01:00
Guzio	0b5db68242	clarification: Correct wording in appservice docs (#2330 ) Some checks failed Spec / 🔎 Validate OpenAPI specifications (push) Has been cancelled Details Spec / 🔎 Check Event schema examples (push) Has been cancelled Details Spec / 🔎 Check OpenAPI definitions examples (push) Has been cancelled Details Spec / 🔎 Check JSON Schemas inline examples (push) Has been cancelled Details Spec / ⚙️ Calculate baseURL for later jobs (push) Has been cancelled Details Spec / 📢 Run towncrier for changelog (push) Has been cancelled Details Spell Check / Spell Check with Typos (push) Has been cancelled Details Spec / 🐍 Build OpenAPI definitions (push) Has been cancelled Details Spec / 📖 Build the spec (push) Has been cancelled Details Spec / 🔎 Validate generated HTML (push) Has been cancelled Details Spec / 📖 Build the historical backup spec (push) Has been cancelled Details Spec / Create release (push) Has been cancelled Details	2026-03-06 19:21:02 +02:00
Logan Devine	57c6273162	Update 2329.clarification	2026-03-04 08:24:32 -08:00
Logan Devine	f49e6858f7	Add newsfragment	2026-03-04 08:22:29 -08:00
Logan Devine	ba3674da8e	add link to JSON signing algorithm on federation auth section	2026-03-04 08:13:13 -08:00
				`@ -0,0 +1 @@`
				`Fix various typos throughout the specification.`
				`@ -0,0 +1 @@`
				`Add link to JSON signing algorithm in server-server auth section for clarity. Contributed by @thetayloredman.`