Updated documentation about the whole craziness