From 3487f5d75a20790a8c9eff2d3734a48891b4ae61 Mon Sep 17 00:00:00 2001 From: David Baker Date: Tue, 14 Nov 2017 15:08:56 +0000 Subject: [PATCH] Spell out what we mean by a 3pid (and consequently rejig all the fixed-width formatting) --- specification/appendices/threepids.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/specification/appendices/threepids.rst b/specification/appendices/threepids.rst index 2f8147a8..e578a559 100644 --- a/specification/appendices/threepids.rst +++ b/specification/appendices/threepids.rst @@ -14,13 +14,13 @@ 3PID Types ---------- -3PIDs represent identifiers on other namespaces that might be associated with a -particular person. They comprise a tuple of `medium` which is a string that -identifies the namespace in which the identifier exists and an `address`: a -string representing the identifier in that namespace. This must be a canonical -form of the identifier, ie. if multiple strings could represent the same -identifier, only one of these strings must be used in a 3PID address, in a -well-defined manner. +Third Party Identifiers (3PIDs) represent identifiers on other namespaces that +might be associated with a particular person. They comprise a tuple of `medium` +which is a string that identifies the namespace in which the identifier exists +and an `address`: a string representing the identifier in that namespace. This +must be a canonical form of the identifier, ie. if multiple strings could +represent the same identifier, only one of these strings must be used in a 3PID +address, in a well-defined manner. For example, for e-mail, the `medium` is 'email' and the `address` would be the email address, eg. the string 'bob@example.com'. Since domain resolution is