readme corrections
minor refactoring of core, world example reorganized