extensive documentation notes