[jitsi-dev] Inconsistent naming (XMPP/Jabber)


#1

I'm starting to write documentation for XMPP/Jabber. For the scenario
described below imagine you are a new user who has never heard of XMPP
or Jabber before.

1. You create a new account via File > Add new account. The network menu
lists "XMPP" (no reference to Jabber). You create an XMPP account.

2. Now that you have an account you type an address into the Jitsi dial
field and click "Call contact". The menu includes a reference to
"Jabber" but does not reference the "XMPP" account that you thought you
just created.

3. You decide to review the accounts you created so you go to Tools >
Options > Accounts. Once again there is no reference to the XMPP account
you thought you created. Instead it refers to "Jabber" again.

It would be helpful if Jitsi stuck to one name for the protocol
throughout the user interface. It is unreasonable to assume that new
users are familiar with both of these technical terms and understand the
relationship between the two terms (i.e. that they refer to exactly the
same thing.

I recommend removing all UI references to "Jabber" and replacing them
with the acronym "XMPP" (since that is now the preferred name for the
protocol).

David


#2

Hey David

I've just committed a change that renames the remaining two localized Jabber
strings to XMPP (a password message and the global proxy option).

The thing you are seeing however is the protocol name used internally. I'm
not sure if that can be changed easily without breaking existing accounts.

Emil? Damencho?

Regards,
Ingo

···

-----Original Message-----
From: David Bolton [mailto:davidkbolton@gmail.com]
Sent: Mittwoch, 13. März 2013 02:14
To: Jitsi Developers
Subject: [jitsi-dev] Inconsistent naming (XMPP/Jabber)
I'm starting to write documentation for XMPP/Jabber. For the scenario
described below imagine you are a new user who has never heard of XMPP
or Jabber before.

1. You create a new account via File > Add new account. The network menu
lists "XMPP" (no reference to Jabber). You create an XMPP account.

2. Now that you have an account you type an address into the Jitsi dial
field and click "Call contact". The menu includes a reference to
"Jabber" but does not reference the "XMPP" account that you thought you
just created.

3. You decide to review the accounts you created so you go to Tools >
Options > Accounts. Once again there is no reference to the XMPP account
you thought you created. Instead it refers to "Jabber" again.

It would be helpful if Jitsi stuck to one name for the protocol
throughout the user interface. It is unreasonable to assume that new
users are familiar with both of these technical terms and understand the
relationship between the two terms (i.e. that they refer to exactly the
same thing.

I recommend removing all UI references to "Jabber" and replacing them
with the acronym "XMPP" (since that is now the preferred name for the
protocol).

David


#3

Hey Ingo,

yes, currently the protocol name is still jabber (the one in
net.java.sip.communicator.service.protocol.ProtocolNames) and we
cannot just change it cause everybody may lose their created accounts.

And this protocol name is used in Account display name, and we need to
find a way to show it with updated value like xmpp. And this is not an
easy task, we have a ProtocolDisplayName in AccountID but this one is
used for other purposes, like using the xmpp protocol as a base for
other protocols, this currently is used for protocols like Google Talk
and Facebook.
We just need to find a way to display localized string in account
display in the gui, like we do for the JabberAccountRegistrationWizard
using the string plugin.jabberaccregwizz.PROTOCOL_NAME.
Hope this clears it a little bit :slight_smile:

Regards
damencho

···

On Wed, Mar 13, 2013 at 10:55 PM, Ingo Bauersachs <ingo@jitsi.org> wrote:

Hey David

I've just committed a change that renames the remaining two localized Jabber
strings to XMPP (a password message and the global proxy option).

The thing you are seeing however is the protocol name used internally. I'm
not sure if that can be changed easily without breaking existing accounts.

Emil? Damencho?

Regards,
Ingo

-----Original Message-----
From: David Bolton [mailto:davidkbolton@gmail.com]
Sent: Mittwoch, 13. März 2013 02:14
To: Jitsi Developers
Subject: [jitsi-dev] Inconsistent naming (XMPP/Jabber)
I'm starting to write documentation for XMPP/Jabber. For the scenario
described below imagine you are a new user who has never heard of XMPP
or Jabber before.

1. You create a new account via File > Add new account. The network menu
lists "XMPP" (no reference to Jabber). You create an XMPP account.

2. Now that you have an account you type an address into the Jitsi dial
field and click "Call contact". The menu includes a reference to
"Jabber" but does not reference the "XMPP" account that you thought you
just created.

3. You decide to review the accounts you created so you go to Tools >
Options > Accounts. Once again there is no reference to the XMPP account
you thought you created. Instead it refers to "Jabber" again.

It would be helpful if Jitsi stuck to one name for the protocol
throughout the user interface. It is unreasonable to assume that new
users are familiar with both of these technical terms and understand the
relationship between the two terms (i.e. that they refer to exactly the
same thing.

I recommend removing all UI references to "Jabber" and replacing them
with the acronym "XMPP" (since that is now the preferred name for the
protocol).

David


#4

yes, currently the protocol name is still jabber (the one in
net.java.sip.communicator.service.protocol.ProtocolNames) and we
cannot just change it cause everybody may lose their created accounts.

Just as I thought. Thanks for the confirmation.

David: can you open a bug report in JIRA for this one?

Regards,
Ingo


#5

Bug filed:
http://java.net/jira/browse/JITSI-1114

David

···

On 3/14/2013 4:06 PM, Ingo Bauersachs wrote:

David: can you open a bug report in JIRA for this one?