improved README and generator