some generators and a readme