added more documentation notes