adding description of annotations and other minor additions