Hi folk,

I was discussing ideas for how to handle incompatibilities between AIM's
chat rooms and Jabber groupchat, and something occured to me.  I wanted to
run the concept by you all and maybe, if it sounds interesting to anyone
else, sit down and write up a formal JEP for evaluation/submission.

Often I run into times when people wonder "well how do I use this?".  I'll
take pyrss as an example (my apologies to the author for me using you  ;) 
).  You have to read the documentation of pyrss itself to figure out what
you are actually support to message pyrss itself and say "help" to get
assistance.  Likewise, with PyAIM's groupchat functionality, it looks like
I am going to have to do some odd things to get compatibility.  So reading
documentation of the actual transport is fine for the person installing
the transport, but what about the end users?

So what I propose is thinking through a stanza to indicate "how do I use
you?".  I haven't looked in details at anything yet, but the idea might be
something like:
<message to="aim.jabber.vorpalcloud.org"
from="[EMAIL PROTECTED]"><usage /></message>

<message from="aim.jabber.vorpalcloud.org"
to="[EMAIL PROTECTED]"><usage>After registering with this
transport, you may communicate through Jabber to users on AIM.  Please
note that some screen names have spaces in them in a real AIM client, but
through this transport, there are no spaces.  As for group chat, prefix
the name of the chat room with a pound (#) symbol and, if there are any
spaces in the name, replace them with underscores (_).  For further
assistance, please see the online documentation at
http://pyaim-t.jabberstudio.org/usage.php.</usage></message>

If the target doesn't understand usage, it should simply ignore the empty
message sent to itself.

Anyway, I just wanted to show a general "concept" of how this might play
out, but if anyone wants me to write up something real, let me know.  I
think this plus client support would make a lot of jabber functionality
easier to understand to end users.  (this would almost be a "balloon help"
or "context sensitive" help thing)

Daniel

-- 
"The most addictive drug in the world is music."
     - The Lost Boyz


_______________________________________________
jdev mailing list
jdev@jabber.org
http://mail.jabber.org/mailman/listinfo/jdev

Reply via email to