From e04ae3090e7c77ea8a5754f996e0bf97218de324 Mon Sep 17 00:00:00 2001 From: Jonas Kress Date: Tue, 13 Jul 2021 12:12:48 +0200 Subject: [PATCH 1/5] Create 3278-enable_set_displayname-capabilities.md --- ...278-enable_set_displayname-capabilities.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 proposals/3278-enable_set_displayname-capabilities.md diff --git a/proposals/3278-enable_set_displayname-capabilities.md b/proposals/3278-enable_set_displayname-capabilities.md new file mode 100644 index 00000000000..0e32d87be17 --- /dev/null +++ b/proposals/3278-enable_set_displayname-capabilities.md @@ -0,0 +1,23 @@ +# MSC3278: Expose enable_set_displayname in capabilities response + + +Some home servers like synapse can be configured to enable_set_displayname: false. To enable clients to handle that gracefully in the UI this setting should be exposed. + +## Proposal + +The m.room_versions capability /_matrix/client/r0/capabilities endpoint could be decorated to provide more information on capabilities. +```javascript +{ + "capabilities": { + "m.enable_set_displayname": false, + "m.room_versions": {...}, + } +} +``` +As part of this MSC, a capability will be added that exposes the server setting: +m.enable_set_displayname +Client recommendations +When presenting profile settings, clients should use capabilities in order to display the correct UI. + +## Unstable prefix +Implementations won't actually be able to use m.enable_set_displayname until the MSC has finished the Final Comment Period. While the MSC is in review, implementations can use an unstable prefix (im.vector.enable_set_displayname) instead. From 0fd7c9435b54bc45c09ef61299f6270fe563a108 Mon Sep 17 00:00:00 2001 From: Jonas Kress Date: Tue, 13 Jul 2021 14:24:36 +0200 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Alexey Rusakov --- proposals/3278-enable_set_displayname-capabilities.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/3278-enable_set_displayname-capabilities.md b/proposals/3278-enable_set_displayname-capabilities.md index 0e32d87be17..bea1d40dea7 100644 --- a/proposals/3278-enable_set_displayname-capabilities.md +++ b/proposals/3278-enable_set_displayname-capabilities.md @@ -5,7 +5,7 @@ Some home servers like synapse can be configured to enable_set_displayname: fals ## Proposal -The m.room_versions capability /_matrix/client/r0/capabilities endpoint could be decorated to provide more information on capabilities. +The `/_matrix/client/r0/capabilities` endpoint could be decorated to provide more information on capabilities. ```javascript { "capabilities": { From c7117067a3e6bdb70afcad165a210cafb2f0f829 Mon Sep 17 00:00:00 2001 From: Jonas Kress Date: Tue, 13 Jul 2021 14:25:43 +0200 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Alexey Rusakov --- proposals/3278-enable_set_displayname-capabilities.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/proposals/3278-enable_set_displayname-capabilities.md b/proposals/3278-enable_set_displayname-capabilities.md index bea1d40dea7..b6d1271ddbf 100644 --- a/proposals/3278-enable_set_displayname-capabilities.md +++ b/proposals/3278-enable_set_displayname-capabilities.md @@ -15,8 +15,9 @@ The `/_matrix/client/r0/capabilities` endpoint could be decorated to provide mor } ``` As part of this MSC, a capability will be added that exposes the server setting: -m.enable_set_displayname -Client recommendations +`m.enable_set_displayname` + +## Client recommendations When presenting profile settings, clients should use capabilities in order to display the correct UI. ## Unstable prefix From 72919922da3276dba63a20e0dcbff526e68c1929 Mon Sep 17 00:00:00 2001 From: Jonas Kress Date: Tue, 13 Jul 2021 19:17:59 +0200 Subject: [PATCH 4/5] Update and rename 3278-enable_set_displayname-capabilities.md to 3279-enable_set_displayname-capabilities.md --- ...bilities.md => 3279-enable_set_displayname-capabilities.md} | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) rename proposals/{3278-enable_set_displayname-capabilities.md => 3279-enable_set_displayname-capabilities.md} (88%) diff --git a/proposals/3278-enable_set_displayname-capabilities.md b/proposals/3279-enable_set_displayname-capabilities.md similarity index 88% rename from proposals/3278-enable_set_displayname-capabilities.md rename to proposals/3279-enable_set_displayname-capabilities.md index b6d1271ddbf..72e4c70ff69 100644 --- a/proposals/3278-enable_set_displayname-capabilities.md +++ b/proposals/3279-enable_set_displayname-capabilities.md @@ -1,4 +1,4 @@ -# MSC3278: Expose enable_set_displayname in capabilities response +# MSC3279: Expose enable_set_displayname in capabilities response Some home servers like synapse can be configured to enable_set_displayname: false. To enable clients to handle that gracefully in the UI this setting should be exposed. @@ -19,6 +19,7 @@ As part of this MSC, a capability will be added that exposes the server setting: ## Client recommendations When presenting profile settings, clients should use capabilities in order to display the correct UI. +If capability is not present the default is true. ## Unstable prefix Implementations won't actually be able to use m.enable_set_displayname until the MSC has finished the Final Comment Period. While the MSC is in review, implementations can use an unstable prefix (im.vector.enable_set_displayname) instead. From 9c8fec04cf29d2725206d1534282ace3e9e0e566 Mon Sep 17 00:00:00 2001 From: Jonas Kress Date: Tue, 13 Jul 2021 19:32:52 +0200 Subject: [PATCH 5/5] Update and rename 3279-enable_set_displayname-capabilities.md to 3282-enable_set_displayname-capabilities.md --- ...abilities.md => 3282-enable_set_displayname-capabilities.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename proposals/{3279-enable_set_displayname-capabilities.md => 3282-enable_set_displayname-capabilities.md} (93%) diff --git a/proposals/3279-enable_set_displayname-capabilities.md b/proposals/3282-enable_set_displayname-capabilities.md similarity index 93% rename from proposals/3279-enable_set_displayname-capabilities.md rename to proposals/3282-enable_set_displayname-capabilities.md index 72e4c70ff69..8e775f396cb 100644 --- a/proposals/3279-enable_set_displayname-capabilities.md +++ b/proposals/3282-enable_set_displayname-capabilities.md @@ -1,4 +1,4 @@ -# MSC3279: Expose enable_set_displayname in capabilities response +# MSC3282: Expose enable_set_displayname in capabilities response Some home servers like synapse can be configured to enable_set_displayname: false. To enable clients to handle that gracefully in the UI this setting should be exposed.