revised and documented notebook