progress on improved documentation