add documentation notes