generator usage documentation expanded