some typography fixes and documentation