Incorrect inline docs for third parameter of activity comment posted actions

[jdgrimes]

The bp_activity_comment_posted and bp_activity_comment_posted_notification_skipped actions are fired in bp_activity_new_comment() with three parameters, the third one being $activity. The $activity var is a BP_Activity_Activity object, but it is documented as an int and said to be the "ID of the activity item being commented on".

I think these docs are just in error and should be updated to indicate that an activity object is passed, not an ID.

[jdgrimes]

Correct the docs

[jdgrimes]

In 7398.diff​ I've just corrected the docs. Somebody might want to double check that this is the correct course of action and the parameter values themselves haven't actually changed at some point.

[boonebgorges]

Good catch. It appears that the docs have been incorrect since the filters were introduced. See [10543].

[boonebgorges]

In 11311:

Correct param docs for bp_activity_new_comment() actions.

Props jdgrimes.
Fixes #7398.