more fixes/ spelling changes, and documentation