summaryrefslogtreecommitdiff
path: root/spec/Account_Manager.xml
diff options
context:
space:
mode:
Diffstat (limited to 'spec/Account_Manager.xml')
-rw-r--r--spec/Account_Manager.xml16
1 files changed, 15 insertions, 1 deletions
diff --git a/spec/Account_Manager.xml b/spec/Account_Manager.xml
index a1aa0f1c..7a183334 100644
--- a/spec/Account_Manager.xml
+++ b/spec/Account_Manager.xml
@@ -153,7 +153,21 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
an Account already exists with the same display name, for instance by
appending a number or the 'account' parameter. Account manager
implementations SHOULD accept an empty string but account editing user
- interfaces should avoid passing an empty string for this parameter.</tp:docstring>
+ interfaces should avoid passing an empty string for this parameter.
+
+ <tp:rationale>
+ <p>The account creation UI may ask the user for a name for the new
+ account. If the author of the UI chooses not to do this, the
+ account creation UI is better able to suggest a default display
+ name because it has protocol-specific knowledge which the account
+ manager does not.</p>
+
+ <p>The account manager always knows the complete list of accounts so
+ it can easily tell whether it should append something to the
+ display name to avoid presenting two identically-named accounts to
+ the user.</p>
+ </tp:rationale>
+ </tp:docstring>
</arg>
<arg name="Parameters" direction="in" type="a{sv}">