diff --git a/index.bs b/index.bs index 0db3e9d0a..86c3adbc3 100644 --- a/index.bs +++ b/index.bs @@ -3593,14 +3593,20 @@ associated with or [=scoped=] to, respectively. : name :: A [=human palatability|human-palatable=] name for the entity. Its function depends on what the {{PublicKeyCredentialEntity}} represents: - - When inherited by {{PublicKeyCredentialRpEntity}} it is a [=human palatability|human-palatable=] identifier for the [=[RP]=], intended only + - \[DEPRECATED] When inherited by {{PublicKeyCredentialRpEntity}} it is a [=human palatability|human-palatable=] identifier for the [=[RP]=], intended only for display. For example, "ACME Corporation", "Wonderful Widgets, Inc." or "ОАО Примертех". + This member is deprecated because many [=clients=] do not display it, + but it remains a required dictionary member for backwards compatibility. + [=[RPS]=] MAY, as a safe default, set this equal to the [=RP ID=]. + - [=[RPS]=] SHOULD perform enforcement, as prescribed in Section 2.3 of [[!RFC8266]] for the Nickname Profile of the PRECIS FreeformClass [[!RFC8264]], when setting {{PublicKeyCredentialEntity/name}}'s value, or displaying the value to the user. - - This string MAY contain language and direction metadata. [=[RPS]=] SHOULD consider providing this information. See [[#sctn-strings-langdir]] about how this metadata is encoded. + - This string MAY contain language and direction metadata. + [=[RPS]=] SHOULD consider providing this information if setting the member to a value other than the [=RP ID=]. + See [[#sctn-strings-langdir]] about how this metadata is encoded. - [=Clients=] SHOULD perform enforcement, as prescribed in Section 2.3 of [[!RFC8266]] for the Nickname Profile of the PRECIS FreeformClass [[!RFC8264]],