some clarity of readme and of comments