[world gen] removing unneeded comments and unused code, improved the documentation in world-gen.h