CLIMATE-392 - Documentation clarifications