more updates to carlo doc