[Telepathy-commits] [telepathy-spec/master] Add tp:rationale explaining the changes to Display_Name documentation.

George Goldberg grundleborg at googlemail.com
Mon Jan 5 11:45:27 PST 2009

 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 a1aa0f1..7a18333 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 name="Parameters" direction="in" type="a{sv}">

More information about the Telepathy-commits mailing list