improve README/parameters validation, some cleaning