[PLAT-3870] added further doc comments