impr(rest-api): improve task comment resource documentation

related to #CAM-2134, #CAM-2135 and #CAM-2148