http://schema.org/Comment
http://schema.org/CommentAction
http://schema.org/UserComments

Schema.org currently has three overlapping types:

Comment: A subtype of CreativeWork described as "A comment on an item". Oddly enough, it does not allow for including the body of the comment. One can only describe the comment (e.g. author, date published, etc.)

CommentAction: "The act of generating a comment about a subject." It also does not include the body of the comment.

UserComments: A subtype of UserInteraction. It is the "event" of commenting. The only way to include the comment body.

The only place where Comment and UserComments are used as an expected type is on the "comment" property of CreativeWork.

This is all very confusing and should be cleaned up.

Status (May 1) for sdo-gozer

TODOs before closing this issue

• first phase implemented, see http://sdo-gozer.appspot.com/docs/releases.html#sdo-gozer
• update the text of UserComment + markup with deprecated:True or whatever #465 resolves
• deprecate UserInteraction and all of its children; also interactionCount (cf replace interactionCount with interaction #137)
• final check that /docs/releases.html represents these changes clearly.