--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/jp/identity.rst	Tue Oct 01 22:49:06 2019 +0200
@@ -0,0 +1,34 @@
+=============================
+identity: identity management
+=============================
+
+Identity use several XMPP extensions (like vcards) to retrieve or set informations about
+an entity. For now it's really basic and only nickname and avatar are managed.
+
+get
+===
+
+Retrieve informations about the identity behind an XMPP entity. You only have to specify
+the jid of the entity, and you'll get (if set) his/her/its nickname and a link to the
+cached avatar.
+
+example
+--------
+
+Get identity information about an entity::
+
+  $ jp identity get somebody@example.org
+
+set
+===
+
+Set identity data to the server, using various XMPP extensions. You set the data to change
+using ``-f KEY VALUE, --field KEY VALUE``, where ``KEY`` can only be ``nick`` at the
+moment.
+
+example
+-------
+
+Set the nickname of default profile::
+
+  $ jp identity set -f nick toto