Update the content or metadata of an existing comment

Updates an existing comment's content or metadata while preserving its relationships and discussion context.
Only the comment author or users with appropriate management permissions can update comments. The update
operation records activity events for tracking and maintains updated timestamps on the comment.

Key Features:

• Updates comment content while preserving relationships and metadata
• Validates user permissions and ownership before allowing modifications
• Maintains activity tracking and updated timestamps for modified comments
• Returns updated comment object with new timestamps and content
• Preserves comment threading and parent-child relationships

Authorization Logic:

1. User must have a valid JWT token with program management scopes
2. Token is valid for this operation
3. User must be the comment author or have management permissions for the entity
4. User must have access to the comment and its parent entity

Usage Example:

Correct typos or update comment content to reflect new information while maintaining discussion context.