an attempt for a better documentation, my horrible english in action