Matrix-doc: Register /.well-known/matrix with IANA

[ara4n]

[jryans]

I have submitted the registration request to the IETF group that reviews them.

[jryans]

The request has been received by IETF mailing list, and now we wait for it to be reviewed, which may take some time.

[Vikingat-RAGE]

This needs to be addressed within the specification as well. The "/.well-known/matrix/client" to my understanding does not conform to RFC 3986. The /.well-known/ must be segment-nz as specified in RFC 7785. Is the application name just going to be "matrix" then?

[uhoreg]

(I'm assuming you mean 5785 ratherthan 7785) The registered name would just be matrix, and would be a directory. This is similar to some other registered .well-known names that are also defined to be directories, such as acme-challenge or dnt

[Vikingat-RAGE]

Yes sorry that was a typo.

[jryans]

Yes, we registered for the name matrix.

[richvdh]

See https://mailarchive.ietf.org/arch/msg/wellknown-uri-review/4x0kkZtC8L-oztGKXGeCOUID0fk for the IETF request.

[jryans]

The .well-known registry request has been reviewed and broadly looks good, but they are suggesting that we provide a more stable / unchanging URL to the specification documents that explain our .well-known behaviour so that we don't need to update the document URLs in the future.

I had previously offered:

https://matrix.org/docs/spec/client_server/r0.4.0.html#well-known-uri
https://matrix.org/docs/spec/server_server/r0.1.1.html#get-well-known-matrix-server

We could instead provide:

https://matrix.org/docs/spec/client_server/unstable.html#well-known-uri
https://matrix.org/docs/spec/server_server/unstable.html#get-well-known-matrix-server

I am not quite sure how they may feel about the word "unstable" in the URL, though I can try to explain it's just the latest reviewed version.

@ara4n @richvdh @uhoreg Since you've interacted with this issue, are there other URLs you would recommend instead? I suppose it would be possible to craft a separate page that just describes .well-known at an unchanging URL, but I wasn't sure if that would be desirable.

Anyway, if I don't hear any replies here soon, I'll offer the unstable URLs above.

[jcgruenhage]

It would be nice to have a "stable" pointer just like we have "unstable", where stable shows the most recent stable release. Would be really useful here, and I'm sure there's other use cases too

[richvdh]

the word you are after is "latest":

https://matrix.org/docs/spec/client_server/latest.html#well-known-uri
https://matrix.org/docs/spec/server_server/latest.html#get-well-known-matrix-server

[jryans]

Aha, thanks all! I will offer the URLs that use latest then.

[jryans]

I have replied with updated spec URLs that use "latest".

[jryans]

The registry experts have approved our request and instructed IANA to add our registration. I'll update this thread once the registration goes live.

[jryans]

IANA has added the registration, so we're all done here. 🎉