comprehensive updates to documentation