documentation tweaks and some graphical upgrades