clearer communication, some corrections in the docs...