improved README and first script