When use @var tag docblock

En gros :
* à utiliser quand la méthode ne permet pas de savoir quel objet vous manipulez
* à ne pas utiliser sinon.

Je suis preneur si vous avez des idées pour améliorer le wording.