smaller changes for individual instances and fix README