revised message docs