miscellaneous updates and integrated documentation