diff options
| author | George Goldberg <grundleborg@googlemail.com> | 2009-01-05 19:45:27 +0000 |
|---|---|---|
| committer | George Goldberg <grundleborg@googlemail.com> | 2009-01-05 19:45:27 +0000 |
| commit | d90ca875715b3317938eec8ef0ffe76a83d1502f (patch) | |
| tree | 05c9f1ebfaf84c386c5b74a4f4a6ebe96ec77ce2 /spec/Account_Manager.xml | |
| parent | a357ebf4b33316e00d6871c9846531cc2a469a1e (diff) | |
Add tp:rationale explaining the changes to Display_Name documentation.
Diffstat (limited to 'spec/Account_Manager.xml')
| -rw-r--r-- | spec/Account_Manager.xml | 16 |
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}"> |