lots of changes to documentation