Merge pull request #2159 from w3c/issue-2121-rp-name

Deprecate rp.name

index.bs

@@ -3593,14 +3593,20 @@ associated with or [=scoped=] to, respectively.
     :   <dfn>name</dfn>
     ::  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]],