Updating a bit the general comments in documentation