lots of changes to documentation especially