doc: more info about the token.

allgo/__init__.py

@@ -123,7 +123,7 @@ class Client:
 
      accessors
        | allgo_url - the url of the instance the user want to ask to.
-       | token     - the user token.
+       | token     - the user token linked to the instance. cf {allgo_url}/profile
        | verify_tls- does tls have to be verified ?
 
      methods

doc/faq.rst

+F.A.Q.
+======
+
+What is the *user token* ?
+--------------------------
+
+| The *user token* is a string that authenticate a user on an allgo instance.
+| It can be found/generated on the allgo instance, on your profile.
+| *{allgo_url}/profile* on allgo18 instances.
+| *{allgo_url}/users/edit* on old version instances.
+| Note: as it linked a user to an instance, the same token cannot be used on another.
+
+The token should be provided to the client constructor or be available as ALLGO_TOKEN env. variable
+or it can be written in the allgo.TOKEN_FILE (without endline).
+
+also cf `the trick for jupyter notebook. <jupyter.rst#trick>`_

doc/index.rst

@@ -50,6 +50,7 @@ Go to doc !
    install
    allgo
    jupyter
+   faq
 
 
 Learn by examples