added many more documentation notes